Overview
Volunteerio is a full-stack volunteer management platform that transforms community service into a competitive, map-based experience. Clubs log hours, grow territory on a live world map, and compete on global leaderboards — making volunteering genuinely engaging for serious organizations like NHS chapters, nonprofits, and school clubs.
Built entirely as the sole developer, the platform handles everything from real-time territory rendering and QR-based event check-ins to multi-admin approval workflows and external partnership affiliations.
Challenge
Volunteer tracking tools are either overly simple (spreadsheets) or bloated enterprise software. There was no platform that made volunteering feel competitive and rewarding while still giving admins the precise control they need over hour approvals, event management, and member accountability.
- Volunteer hours needed to map to physical locations and grow visible territory on a live map
- Different events require completely different check-in flows (open, password, admin QR scan, or member QR scan)
- Clubs needed support for external partner organizations contributing hours without joining the club directly
- Admins needed granular control — multi-admin thresholds, inline hour editing, conditional time-based grants, and CSV exports
- Territory had to decay over time to keep competition fresh and location-specific
Solution
I designed and built Volunteerio from scratch as a gamified, club-based volunteer platform with four core systems working together:
Territory Mechanics
Every approved hour submission at a location expands the club's circle on the world map. Circles grow logarithmically — early hours push territory fast, but it takes significantly more effort to expand further. When circles from the same club overlap, they merge using smooth metaball blending. Territory decays slowly without activity, keeping competition dynamic with configurable decay rate, floor, and bonus multipliers.
Four Event Types
Every event type is purpose-built for how check-ins actually work in the field:
- Open Events: No check-in required — volunteers submit hours freely after attending. Perfect for ongoing community service.
- Password Events: Organizers share a code that volunteers enter when submitting. Prevents unauthorized submissions without face-to-face check-in.
- Admin Scans You: Each volunteer has a personal QR code on their profile. An organizer scans it at arrival and departure — time is recorded automatically.
- You Scan the Event: The organizer displays a QR code at the venue. Volunteers scan to check in and out. Ideal for large events with many simultaneous arrivals.
For QR events, check-in and check-out times are recorded to the minute. Admins can set conditional rules — "attended more than 1.5 hours → grant 2 hours" or "attended less than 30 minutes → grant 0" — to automatically compute hours when granting.
Partnership System
External organizations — food banks, nonprofits, businesses — can register as Partnerships and affiliate with any club. Members volunteer with them without needing to join a separate organization. Partners create their own events, and members submit hours directly to the partnership — counting toward their club totals. If a partner isn't granting hours, club admins can step in and submit pending hours on behalf of their members.
Hours Logs & Admin Tools
Admins create named tracking periods — "Fall Semester" or "Summer 2026" — with hour requirements. Volunteers submit hours to specific logs. Admins see per-log progress, export to CSV, inline-edit individual hours, and grant hours directly for special occasions tagged as "Granted by Admin" for full transparency. Multi-admin approval thresholds are configurable per club.
Key Features
- Live Territory Map: Real-time world map with logarithmic circle growth and metaball merging for overlapping club territories
- Global Leaderboards: Club rankings update automatically as hours are approved — territory size reflects standing
- Four Check-in Modes: Open, password, admin QR scan, and member QR scan — each purpose-built for different event scenarios
- Conditional Hour Rules: Time-based conditionals for QR events compute granted hours automatically based on attendance duration
- Partnership Affiliations: External orgs can affiliate with clubs — their events and hours flow directly into member totals
- Decay System: Territory circles decay without activity, keeping location competition fresh and configurable per admin
- Hours Logs: Named tracking periods with per-member progress, requirement thresholds, and CSV export
- Multi-Admin Support: Configurable approval thresholds, inline editing, and direct admin grants with full audit transparency
- Google Auth: One-click sign-in — no setup required to start volunteering or create a club
Impact
Volunteerio reframes volunteer tracking from a chore into something worth competing over. By tying every hour to a physical location and visible territory growth, the platform gives volunteers a tangible, real-time representation of their impact on the map — and on the leaderboard.
- Grew to over 10,000 volunteers by boosting engagement through gamified territory mechanics and live global competition
- Built end-to-end as a sole developer — from database schema and API design to frontend rendering and real-time map updates
- Territory mechanics introduce genuine competition between clubs at a granular, location-level resolution
- Partnership system extends the platform beyond single organizations, enabling broader community collaboration
- Conditional hour rules eliminate manual calculations for large QR-based events