Skip to content

Repository files navigation

🍽️ Food Pantry App

The Food Pantry App aims to bridge the gap between food bank pantries and families looking for free food. By leveraging technology, this app connects families in need with food resources, helps with meal ideas, and facilitates donations to food banks.

Screenshot 2025-02-23 at 12 33 34 PM

Connecting families with the resources they need.


📑 Table of Contents


🚀 Features

1. 🗺️ Find Nearby Food Pantries

  • Use the Google Maps API to locate the nearest food pantry.
  • Displays available food at the pantry in real-time.
Screenshot 2025-02-23 at 12 24 02 PM

2. 🍴 Healthy Meal Suggestions

  • Powered by OpenAI API, the app generates healthy meal ideas based on the ingredients available at the pantry.
Screenshot 2025-02-23 at 12 25 52 PM Screenshot 2025-02-23 at 12 26 44 PM

3. 🍔 Reserve Food & Delivery Orders

  • Reserve food from food banks and order delivery for a small fee.
  • Delivery Fee and $5 Service Charge apply for each order.
Screenshot 2025-02-23 at 12 27 23 PM Screenshot 2025-02-23 at 12 27 53 PM

4. 💸 Donate to Food Banks

  • Donate food and money to local food banks to help others in need.
Screenshot 2025-02-23 at 12 28 17 PM

⚙️ Technologies Used

  • Google Maps API 🗺️: To find food pantries near users.
  • OpenAI API 🤖: For generating healthy meal suggestions based on pantry food.
  • React ⚛️: Frontend framework for the user interface.
  • Stripe API 💳: Payment integration for processing delivery fees and donations.

🎯 Usage

Once the app is up and running:

  1. Find a nearby food pantry:
    Enter your location or allow the app to use your current location. The app will display food banks near you with available food. Select a specific food bank, and the food available for distribution will render.

  2. Get healthy meal suggestions:
    Explore meal ideas based on the food available at the selected pantry using OpenAI's suggestions.

  3. Reserve food and place a delivery order:
    Select food from a pantry, reserve it, and arrange delivery. The app will handle payments for delivery and service fees.

  4. Donate food and money:
    Use the donation feature to contribute food or money to a local food bank.


💡 Contributing

We welcome contributions to improve the Food Bridge App. Here's how you can contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Make your changes.
  4. Commit your changes (git commit -am 'Add new feature').
  5. Push to your branch (git push origin feature/your-feature).
  6. Open a pull request.

📜 License

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


🌱 Thank You for Using Food Pantry App!

Together, we can fight hunger and help those in need. 🍴


About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages