https://github.com/codewithbalaji/hunger-free-webiste
Hunger Free is a website dedicated to fighting hunger by connecting contributors with surplus food to volunteers who distribute it to those in need.
https://github.com/codewithbalaji/hunger-free-webiste
bootstrap5 firebase reactjs sass
Last synced: 3 months ago
JSON representation
Hunger Free is a website dedicated to fighting hunger by connecting contributors with surplus food to volunteers who distribute it to those in need.
- Host: GitHub
- URL: https://github.com/codewithbalaji/hunger-free-webiste
- Owner: codewithbalaji
- Created: 2024-04-16T14:13:39.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-12T13:04:25.000Z (about 2 years ago)
- Last Synced: 2024-05-12T14:24:34.765Z (about 2 years ago)
- Topics: bootstrap5, firebase, reactjs, sass
- Language: JavaScript
- Homepage: https://hungerfree.vercel.app/
- Size: 4.02 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 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**:
```bash
git clone https://github.com/yourusername/hunger-free.git
```
2. **Install dependencies**:
```bash
npm install
```
3. **Start the server**:
```bash
npm start
```
4. **Access the website** at [http://localhost:5173/](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.