Voluntree

Overview

Voluntree is a comprehensive volunteer management platform that connects passionate volunteers with meaningful causes to create positive change in communities. It is our HackByte 3.0 hackathon project built within strict deadline of 36 hours.

Features

• Trust Score System: Reliability metric for volunteers based on completed events and reviews
• Organization Profiles: Detailed profiles for non-profits to showcase their mission and upcoming events
• Volunteer Profiles: Rich profiles highlighting skills, interests, and volunteer history
• Event Management: Create, manage, and track participation for volunteer events
• Application Processing: Streamlined workflow for reviewing and accepting volunteer applications
• Analytics Dashboard: Insights on volunteer engagement and impact metrics

Screenshots

Technologies Used

Frontend

• React + TypeScript
• Tailwind CSS
• shadcn/ui component library
• React Router
• Axios for API requests
• React Query for data fetching
• Recharts for data visualization

Backend

• Node.js + Express
• MongoDB with Mongoose
• JWT authentication
• Google Generative AI (Gemini) for matching algorithm

Getting Started

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)
• MongoDB

Installation

# Clone the repository
git clone https://github.com/yourusername/Voluntree.git

# Navigate to the project directory
cd Voluntree

# Install dependencies
npm install

# Start the development server
npm start

Usage

[Include screenshots, code examples, or instructions on how to use the application]

Project Structure

Voluntree/
├── frontend/        # Frontend code
│   ├── public/      # Static files
│   ├── src/         # Source code
│   │   ├── components/  # React components
│   │   ├── pages/       # Page components
│   │   ├── utils/       # Utility functions
│   │   └── ...
├── backend/         # Backend code
│   ├── controllers/ # Route controllers
│   ├── models/      # Database models
│   ├── routes/      # API routes
│   ├── utils/       # Utility functions
│   └── ...
└── ...

Future Enhancements

• Integration with social media platforms for event sharing
• Advanced analytics with machine learning insights
• Intelligent algorithm matches volunteers with events based on skills, interests, and past experiences

Contributors

• Govind Dwivedi
• Manbir Singh
• Arnav Kesari

License

This project is licensed under the MIT License - see the LICENSE file for details.