A modern full-stack platform that intelligently connects volunteers with organizations through AI-based matching, location-aware discovery, and seamless event management.
- Problem Statement: PS No. 4.3 โ VolunteerCompass
- Team Name: Team Meow ๐พ
Community service is powerful, but highly unorganized.
- Volunteers struggle to find relevant opportunities
- NGOs and organizers rely on scattered platforms like WhatsApp
- Skilled volunteers remain unmatched while events stay understaffed
VolunteerConnect bridges this gap by:
- ๐ฏ Matching volunteers with events using intelligent scoring
- ๐บ๏ธ Showing nearby opportunities via map-based discovery
- ๐ข Helping organizers manage events and volunteers efficiently
- ๐จ Highlighting urgent hiring needs
- ๐ Tracking volunteer impact and participation
- Next.js (App Router)
- React.js
- TypeScript
- Tailwind CSS
- Next.js API Routes / Server Actions
- NeonDB (Serverless PostgreSQL)
- Drizzle ORM
- JWT / NextAuth (if used)
- Leaflet / Google Maps API
The application follows a modern full-stack serverless architecture:
- Frontend (Next.js) โ UI & user interaction
- Backend (API Routes) โ business logic & APIs
- Database (NeonDB) โ scalable PostgreSQL storage
- ORM (Drizzle) โ type-safe database queries
- ๐ AI-based event recommendations
- ๐ Match percentage system
- ๐บ๏ธ Map-based nearby event discovery
- ๐ RSVP tracking (Pending / Accepted / Rejected)
- ๐ Impact stats (hours, events, categories)
- ๐ง Skill-based personalization
- โ Create and manage events
- ๐ก๏ธ NGO verification system
- ๐ฅ Volunteer selection dashboard
- ๐ Event analytics
- ๐จ Urgent hiring toggle
- ๐ฏ Intelligent matching engine
- ๐บ๏ธ Location-based filtering
- ๐ข Announcements system
- ๐ฐ Conditional payment system (Private events only)
matchScore = ( skillsMatch * 0.5 + locationMatch * 0.2 + interestMatch * 0.2 + availabilityMatch * 0.1 )
- โ 75%+ โ High Match
- โก 40โ75% โ Medium Match
- โ <40% โ Low Match
-
๐ Event markers based on location
-
๐จ Color-coded matches:
- ๐ด High match
- ๐ก Medium match
- โช Low match
-
๐ฑ๏ธ Click to view event details
- NGOs must provide a registration number
- Events can only be created after verification
- Prevents fake or untrusted listings
- Events marked as Urgent ๐จ
- Shown at top of listings
- Helps fill last-minute volunteer needs
- Volunteer profile
- Skills & experience
- Match percentage
- Total work hours
- โ Accept
- โ Reject
- Application status updates
- RSVP tracking
Acts as a digital portfolio:
- Skills & interests
- Event participation history
- Total contribution time
- Recent projects
git clone https://github.com/your-username/VolunteerConnect
cd VolunteerConnect
npm install
npm run dev- Landing Page
* Volunteer Dashboard
* Organizer Dashboard
We use a modern serverless architecture combining Next.js full-stack capabilities with NeonDB and Drizzle ORM, ensuring scalability, low latency, and efficient data handling without managing a separate backend server.
- ๐ฑ Mobile application
- ๐ Real-time notifications (WebSockets)
- ๐ค Advanced AI recommendations
- ๐ Gamification (badges & rewards)
- ๐ง Email alerts system
Contributions are welcome! Feel free to fork this repo and submit a PR.
If you like this project, please โญ the repo!