Skip to content

Latest commit

ย 

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ VolunteerConnect

๐Ÿพ Team Meow | PS No. 4.3 โ€“ VolunteerCompass

A modern full-stack platform that intelligently connects volunteers with organizations through AI-based matching, location-aware discovery, and seamless event management.


๐Ÿ† Hackathon Details

  • Problem Statement: PS No. 4.3 โ€“ VolunteerCompass
  • Team Name: Team Meow ๐Ÿพ

โ— Problem Statement

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

๐Ÿ’ก Solution

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

โš™๏ธ Tech Stack

Frontend:

  • Next.js (App Router)
  • React.js
  • TypeScript
  • Tailwind CSS

Backend:

  • Next.js API Routes / Server Actions

Database:

  • NeonDB (Serverless PostgreSQL)

ORM:

  • Drizzle ORM

Authentication:

  • JWT / NextAuth (if used)

Maps & APIs:

  • Leaflet / Google Maps API

๐Ÿ—๏ธ Architecture Overview

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

โœจ Features

๐Ÿ‘ค Volunteer Features

  • ๐Ÿ” 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

๐Ÿข Organizer Features

  • โž• Create and manage events
  • ๐Ÿ›ก๏ธ NGO verification system
  • ๐Ÿ‘ฅ Volunteer selection dashboard
  • ๐Ÿ“Š Event analytics
  • ๐Ÿšจ Urgent hiring toggle

๐Ÿš€ Advanced Features

  • ๐ŸŽฏ Intelligent matching engine
  • ๐Ÿ—บ๏ธ Location-based filtering
  • ๐Ÿ“ข Announcements system
  • ๐Ÿ’ฐ Conditional payment system (Private events only)

๐Ÿง  Matching Algorithm

matchScore = ( skillsMatch * 0.5 + locationMatch * 0.2 + interestMatch * 0.2 + availabilityMatch * 0.1 )

๐Ÿ“Š Match Categories:

  • โœ… 75%+ โ†’ High Match
  • โšก 40โ€“75% โ†’ Medium Match
  • โŒ <40% โ†’ Low Match

๐Ÿ—บ๏ธ Map Features

  • ๐Ÿ“ Event markers based on location

  • ๐ŸŽจ Color-coded matches:

    • ๐Ÿ”ด High match
    • ๐ŸŸก Medium match
    • โšช Low match
  • ๐Ÿ–ฑ๏ธ Click to view event details


๐Ÿ›ก๏ธ NGO Verification

  • NGOs must provide a registration number
  • Events can only be created after verification
  • Prevents fake or untrusted listings

๐Ÿšจ Urgent Hiring Feature

  • Events marked as Urgent ๐Ÿšจ
  • Shown at top of listings
  • Helps fill last-minute volunteer needs

๐Ÿ‘ฅ Volunteer Selection System

Organizer View:

  • Volunteer profile
  • Skills & experience
  • Match percentage
  • Total work hours

Actions:

  • โœ… Accept
  • โŒ Reject

Volunteer View:

  • Application status updates
  • RSVP tracking

๐Ÿ‘ค Volunteer Profile

Acts as a digital portfolio:

  • Skills & interests
  • Event participation history
  • Total contribution time
  • Recent projects

๐Ÿš€ Getting Started

git clone https://github.com/your-username/VolunteerConnect
cd VolunteerConnect
npm install
npm run dev

  • Landing Page
image image * Volunteer Dashboard image image image * Organizer Dashboard image image image

๐Ÿง  Architecture Highlight

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.


๐Ÿ”ฎ Future Scope

  • ๐Ÿ“ฑ Mobile application
  • ๐Ÿ”” Real-time notifications (WebSockets)
  • ๐Ÿค– Advanced AI recommendations
  • ๐Ÿ† Gamification (badges & rewards)
  • ๐Ÿ“ง Email alerts system

๐Ÿค Contributing

Contributions are welcome! Feel free to fork this repo and submit a PR.


โญ Support

If you like this project, please โญ the repo!


About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages