Skip to content

YK-03/SharePlate

Repository files navigation

🍱 SharePlate

📌 Overview

SharePlate is a community-driven food rescue platform that bridges the gap between surplus and scarcity by connecting food donors with verified NGOs.

It transforms excess food into meaningful impact through a structured system of claiming, volunteer coordination, and delivery—ensuring that no edible food goes to waste while communities in need are served efficiently and safely.


🖼️ Preview

SharePlate Screenshot


🚀 Features

  • 🧑‍🍳 Donors can list surplus food
  • 🏢 NGOs can browse and claim donations
  • 🚚 Volunteer assignment for pickup & delivery
  • 🔐 Admin verification of users (Donors/NGOs/Volunteers)
  • ⭐ Feedback system after delivery
  • 📍 Location-aware coordination (extendable)

🔄 Workflow

  1. Donor posts food details
  2. Nearby NGOs view available donations
  3. NGO claims the donation
  4. Volunteer is assigned by NGO
  5. Food is picked up and delivered
  6. NGO provides feedback

🔐 User Roles

  • Donor: Upload surplus food
  • NGO: Claim and manage donations
  • Volunteer: Handle pickup and delivery
  • Admin: Verify users and maintain trust

🛠️ Tech Stack

  • Frontend: React
  • Backend: Django (Python)
  • Database: SQLite
  • Auth: Role-based authentication system

⚙️ Setup Instructions

📦 Prerequisites

  • Node.js (v16+ recommended)
  • Python (v3.8+)
  • pip
  • Virtual environment (venv)

🚀 Run the Project

# ===== Frontend Setup =====
cd shareplate_frontend
npm install
npm run dev

# ===== Backend Setup =====
cd ../shareplate_backend

# Activate virtual environment (Windows PowerShell)
.\venv\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt

# Apply migrations
python manage.py migrate

# Run server
python manage.py runserver

# 🌐 Access the App

Open your browser and go to:
http://127.0.0.1:8080/

About

SharePlate is a food donation and distribution platform that connects donors with NGOs to reduce food wastage and ensure surplus food reaches those in need. It introduces a structured workflow involving donors, NGOs, volunteers, and admin verification for trust and accountability.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors