VolunteerGo is a gamified volunteer matching platform that connects volunteers with opportunities based on their skills, interests, and location.
It blends community service with game-like elements such as points, badges, and leaderboards to make volunteering more engaging and rewarding.
- Firebase authentication
- Personalized onboarding to capture interests, skills, and location
- Fun, game-like profile page with earned and locked badges
- AI-powered opportunity search using OpenAI + vector embeddings
- Filter, sort, and voice search support
- Swipe-to-save or swipe-to-skip opportunities
- Save opportunities for later
- One-click application flow
- Category-based badge earning during applications
- Points system with level progression
- Badge collection (earned and locked states)
- Leaderboard with friend system
- React + Vite
- Custom CSS styling
- Firebase Authentication
- Node.js + Express
- FastAPI (AI search service) with Uvicorn
- PostgreSQL + Prisma ORM
- OpenAI embeddings (vector search)
- scikit-learn, NumPy, sentence-transformers
- LocationIQ (geolocation)
- Pexels (media assets)
- SendGrid (email notifications)
GitHub: VolunteerGo
Click the GIF above or watch the full video here:
VolunteerGo - 5 August 2025 - Watch Video
- Node.js v18+
- Python 3.10+
- PostgreSQL database
- Firebase project with Google sign-in enabled
# Clone the repository
git clone https://github.com/Jandresol/VolunteerGo.git
cd VolunteerGo
# Install frontend dependencies
cd VolunteerUI
npm install
# Install backend dependencies
cd VolunteerAPI
npm install
# Install AI search service dependencies
cd VolunteerSearch
pip install -r requirements.txt# Start frontend
cd VolunteerUI
npm run dev
# Start backend
cd VolunteerAPI
npm run dev
# Start AI search
cd VolunteerSearch
uvicorn main:app --reload