Team Code Commandos Official Hackathon Project

Sustainable Development 🌲 Through Technology 💻

Hunger Free is a website dedicated to fighting hunger by connecting contributors with surplus food to volunteers who distribute it to those in need. Our platform aims to organize the process of collecting surplus food from contributors and distributing it to needy people through volunteers. ♻✅

Here is a preview of our web-view for our amazing platform!

Screenshots

• Homepage
• Footer Page
• About Us Page
• User Review
• Contact Us Page

Features

• Contributor Interface: Easily post surplus food availability.
• Volunteer Network: Connect with volunteers to collect and distribute food.
• Contribution Management: Manage and delete posts about surplus food.
• User Authentication: Secure login system for contributors, volunteers, and admins.
• User Roles: Differentiate between contributors, volunteers, and admins for efficient management.

Installation

To get started with Hunger Free locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/hunger-free.git

2. Install dependencies:

   npm install

3. Start the server:

   npm start

4. Access the website at http://localhost:5173/ in your web browser.

Our Final Deployments

• Website: [https://hungerfree.vercel.app/]
• WebApp: [https://hungerfree-app.vercel.app/]
• Repo link for WebApp: [https://github.com/codewithbalaji/hunger-free-web-app]

Contributing

We welcome contributions from the community! If you'd like to contribute to Hunger Free.

Support

For any questions or issues, please reach out to us at balaji01975@gmail.com.