Skip to content

VAMSHIYADAV46/SHARE-PLATE

Repository files navigation

🍽️ Share Plate — Bridging Food Donors & Receivers

Share Plate is a community-driven platform designed to minimize food wastage by seamlessly connecting food donors with those in need. Whether you're an individual, restaurant, or organization, you can contribute to a sustainable future by donating surplus food. 🌍💚


🚀 Key Features

  • 🎁 Donor & Receiver Registration – Easy sign-up process for both donors and receivers.
  • 📍 Real-Time Matching – Instantly connects donors with nearby receivers.
  • 🍲 Food Donation Listings – Donors can list surplus food with details like type, quantity, and expiration.
  • 🔔 Instant Notifications – Receivers get real-time alerts when new donations become available.
  • 🗺️ Interactive Map – Integrated map for easy visualization of donation locations.

🎯 Why Share Plate?

Share Plate is more than a platform—it's a movement to combat food waste by ensuring excess food reaches those who need it the most. Our goal is to make donating surplus food effortless while fostering community engagement and promoting sustainability.


🔧 Tech Stack

  • Backend: Node.js, Express.js
  • Frontend: HTML5, CSS3, JavaScript
  • Database: MongoDB (for user and donation data)
  • APIs: Google Maps API (for location services)

📖 How It Works

  1. Register – Sign up as a donor or receiver.
  2. Log In – Access your personalized dashboard.
  3. List Donations – Donors add food details (quantity, type, expiration date).
  4. Browse Listings – Receivers explore nearby available donations.
  5. Receive Notifications – Get alerts for new food donations in your area.
  6. Contact Donors – Arrange pickup details directly with donors.
  7. Confirm Pickup – Both parties confirm successful transactions.

⚙️ Installation & Setup

Follow these steps to run Share Plate locally:

1️⃣ Clone the Repository

git clone https://github.com/your-username/share-plate.git

2️⃣ Install Dependencies

cd share-plate
npm install

3️⃣ Configure Environment Variables

Create a .env file in the root directory and add:

PORT=5000
MONGODB_URI=your_mongodb_uri

4️⃣ Start the Server

npm start

5️⃣ Access the Application

Open your browser and visit:

http://localhost:5000

🚀 Developer Guide

Prerequisites:

  • Node.js – Install from Node.js Official Site.
  • MongoDB – Set up a local or cloud-based MongoDB instance.

🤝 Contribute & Make an Impact

Want to help us grow Share Plate? Here's how you can contribute:

  • 🐛 Report Bugs – Open an issue on GitHub.
  • ✨ Suggest Features – Share your ideas to improve the platform.
  • 🔧 Submit Pull Requests – Fork the repo, make changes, and contribute!

Every contribution helps in reducing food waste worldwide! 🌱


📜 License

Share Plate is licensed under the MIT License. Feel free to use and modify it for your needs. For more details, refer to the LICENSE file.


📞 Contact & Support

Have questions or suggestions? Reach out to us:


🌟 Built with Purpose & Passion

Join us in making a real difference—one plate at a time! 💛🍽️

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published