https://github.com/harshavardhan-md/sharity
https://github.com/harshavardhan-md/sharity
css3 html5 js python3 sqlite
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/harshavardhan-md/sharity
- Owner: harshavardhan-md
- Created: 2024-02-25T02:07:30.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-07T08:15:54.000Z (over 1 year ago)
- Last Synced: 2025-01-07T08:49:45.384Z (over 1 year ago)
- Topics: css3, html5, js, python3, sqlite
- Language: CSS
- Homepage:
- Size: 20.4 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌟 Sharity
## *Sharing Hope - Food Redistribution Network: Connecting Surplus to the Needy*
[](/)
[](/)
[](/)
[](/)
[](/)
[](/)
> *Bridging the gap between surplus and scarcity - HackMol 5.0 Project*
## 🏆 HackMol 5.0 Achievement
### 🌟 **Top 50 All India Selection** 🌟
*Selected among 4000+ participants nationwide for the final round at NIT Jalandhar*
### Certificate of Participation
## 🌍 Vision
Sharity is more than just a web application - it's a movement to transform how we think about food waste and hunger. By connecting those with surplus food to those in need, we're building a more sustainable and compassionate world, one meal at a time.
### 🎯 Mission
- Reduce food waste from events and institutions
- Provide dignified access to food for those in need
- Create a sustainable model for food redistribution
- Build a community of conscious food donors
## ✨ Features
### 🎁 For Donors
- **Quick Donation**: Easy-to-use interface for registering surplus food
- **Real-time Updates**: Track when food is claimed and delivered
- **Impact Dashboard**: See the difference your donations make
- **Scheduling**: Plan future donations from recurring events
### 🤝 For Recipients
- **Dignity-First Approach**: Respectful access to available food
- **Location-Based Matching**: Find nearby donations
- **Dietary Preferences**: Filter according to specific needs
- **Mobile-Friendly**: Access platform on any device
### 📊 Platform Features
- **Smart Matching**: Efficient allocation of food resources
- **Quality Control**: Food safety verification system
- **Analytics**: Track impact and distribution patterns
- **Community Building**: Connect donors with recipients
## 🛠️ Technical Stack
### Frontend
```text
- HTML5: Semantic structure
- CSS3: Responsive design
- JavaScript: Interactive features
- Bootstrap: UI components
```
### Backend
```text
- Python: Core logic
- Flask: Web framework
- SQLite: Database
- JWT: Authentication
```
### Tools & Utilities
```text
- VSCode: Development
- Git: Version control
- ChatGPT: Development assistance
- Replit: Collaborative coding
```
## 🚀 Quick Start
1. **Clone Repository**
```bash
git clone https://github.com/yourusername/sharity.git
cd sharity
```
2. **Setup Environment**
```bash
python -m venv env
source env/bin/activate # Windows: env\Scripts\activate
pip install -r requirements.txt
```
3. **Initialize Database**
```bash
flask db init
flask db migrate
flask db upgrade
```
4. **Run Application**
```bash
python app.py
```
5. **Access Website**
```text
Open browser and navigate to: http://localhost:5000
```
## 📊 Impact Metrics
### Achievement Aims
- 🍱 **1,000+** Meals Redistributed
- 🏢 **50+** Regular Donors
- 👥 **200+** Recipients Helped
- 🌱 **2,000 kg** Food Waste Reduced
### Goals
- 📈 Reach 5,000 meals redistributed
- 🤝 Partner with 100 institutions
- 🌍 Expand to 5 new cities
- ♻️ Reduce 10,000 kg food waste
## 💡 Innovation
### Technical Innovation
- **Smart Matching Algorithm**: Efficient food distribution
- **Quality Verification**: Food safety checks
- **Real-time Tracking**: Live donation status
- **Scalable Architecture**: Ready for growth
### Social Innovation
- **Community Building**: Connecting donors and recipients
- **Education**: Food waste awareness
- **Dignity-First**: Respectful food access
- **Sustainable Impact**: Long-term solution
## 👥 Team Cosmic
Meet the minds behind Sharity:
[](https://www.linkedin.com/in/harshavardhan-md/)
[](https://www.linkedin.com/in/Kishore-SR)
[](https://www.linkedin.com/in/hitesh-p-aa55662a3)
[](https://www.linkedin.com/in/jeevan-n-39a5652a3)
## 🤝 Contributing
We welcome contributions! Here's how you can help:
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit changes (`git commit -m 'Add AmazingFeature'`)
4. Push to branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📞 Contact & Support
- 📧 Email: support@sharity.org
- 💬 Discord: [Join our community](#)
- 🐦 Twitter: [@SharityOrg](#)
- 📱 Instagram: [@Sharity_Official](#)
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**Together, we can make hunger history** 🌍
[⬆ Back to Top](#-sharity)