🍲 FoodLink

FoodLink is an application designed to bridge the gap between donors who want to contribute food items and local organizations that distribute these donations to those in need.

🚀 Introduction

FoodLink aims to simplify the process of food donation by providing a user-friendly platform for donors to submit their donations and for local organizations to efficiently manage and distribute these donations. By using FoodLink, donors can contribute surplus food items and ensure they reach those who need them the most.

🎉 Features

• Donor Interface:

  • Add details about the food donation, including type, quantity, expiry date, dietary restrictions, and allergen information.
  • Specify pickup or drop-off preferences and provide contact information.
  • Upload photos of the donation items.

• Local Organization Interface:

  • Accept and manage incoming food donations.
  • Schedule pickup or collection times with donors.
  • Coordinate distribution to individuals and families in need.

• Real-time Notifications:

  • Keep donors and local organizations informed about the status of donations, pickups, and distributions.

• User Authentication:

  • Secure user accounts and verify the authenticity of donors and organizations.

• Location Services:

  • Utilize GPS to aid donors and organizations in locating nearby drop-off points or distribution centers.

• Feedback and Reporting:

  • Collect feedback from donors and recipients to improve the donation process.
  • Generate reports for local organizations to track donations and distributions.

🤝 Contributing

We welcome contributions to enhance FoodLink's functionality and user experience. To contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and test thoroughly.
4. Commit your changes with a descriptive commit message.
5. Push your changes to your forked repository.
6. Create a pull request to the main repository's main branch.

🏁 Getting Started

To run the application run the script (script/run_dev.sh)

.\script\run_dev.sh

📝 License

This project is licensed under the MIT License.

---

Thank you for your interest in FoodLink! Your contributions and support will help make a positive impact in providing food to those in need. If you have any questions or feedback, please reach out to us at asterjoules@gmail.com.