Skip to content

RitujaSinha/ShareBowl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

71 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿฒ ShareBowl

A MERN Stack platform that connects food donors with verified NGOs to reduce food wastage and support communities in need.


๐Ÿ“– Project Overview

Food wastage is a major global issue while millions of people continue to face hunger every day. Restaurants, households, events, and businesses often have surplus food that goes unused because there is no efficient way to distribute it.

ShareBowl aims to bridge this gap by providing a platform where donors can easily donate food and groceries to verified NGOs. The platform simplifies donation management, improves transparency, and helps ensure that surplus food reaches people who need it most.


๐Ÿš€ Project Description

ShareBowl is a full-stack MERN web application designed to facilitate food donations between donors and NGOs.

Users can register as donors and create food donation posts. NGOs can register on the platform and, after receiving admin approval, access donation requests and manage food collection. The application provides secure authentication, donation tracking, NGO approval workflows, email notifications, and dedicated dashboards for each user role.

The goal of ShareBowl is to reduce food waste and create a sustainable donation ecosystem through technology.


โœจ Features

  • ๐Ÿ” JWT-Based Authentication
  • ๐Ÿ‘ค Role-Based Access Control (Donor, NGO, Admin)
  • ๐Ÿฑ Food & Grocery Donation Management
  • ๐Ÿข NGO Registration & Approval System
  • โœ… Donation Acceptance/Rejection Workflow
  • ๐Ÿ“ง Email Notifications for NGO Approval
  • ๐Ÿ“Š Donor Dashboard
  • ๐Ÿ“‹ NGO Dashboard
  • ๐Ÿ› ๏ธ Admin Management Panel
  • ๐Ÿ“ฑ Responsive User Interface

๐Ÿ—๏ธ System Workflow

Donor Workflow

  1. Register/Login
  2. Create Food Donation
  3. Select NGO
  4. Submit Donation Request
  5. Track Donation Status

NGO Workflow

  1. Register NGO Account
  2. Wait for Admin Approval
  3. Get Approval Email
  4. Login After Approval
  5. View Incoming Donations
  6. Accept or Reject Donations
  7. Coordinate Food Pickup

Admin Workflow

  1. Review NGO Applications
  2. Approve or Reject NGOs
  3. Monitor Donations
  4. Manage Platform Activities

๐Ÿ’ป Tech Stack

Frontend

  • React.js
  • Tailwind CSS
  • JavaScript
  • React Router DOM

Backend

  • Node.js
  • Express.js

Database

  • MongoDB
  • Mongoose

Authentication

  • JWT Authentication
  • bcrypt

Additional Services

  • Nodemailer

๐Ÿ“‚ Project Structure

ShareBowl/
โ”‚
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ public/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ””โ”€โ”€ App.jsx
โ”‚
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ controllers/
โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”œโ”€โ”€ middleware/
โ”‚   โ”œโ”€โ”€ config/
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ””โ”€โ”€ server.js
โ”‚
โ””โ”€โ”€ README.md

โš™๏ธ Installation

1. Clone Repository

git clone https://github.com/RitujaSinha/ShareBowl.git
cd ShareBowl

Frontend Setup

cd frontend
npm install
npm run dev

Backend Setup

cd backend
npm install
npm run dev

๐Ÿ”‘ Environment Variables

Create a .env file inside the backend folder and add:

PORT=5000
Use env-example to create env variables


๐Ÿšง Current Limitations

  • Email OTP Verification is not implemented.
  • Real-time chat functionality is not available.
  • Pickup scheduling is currently handled manually.
  • Location-based NGO recommendations are not available.

๐Ÿ”ฎ Future Improvements

๐Ÿ’ฌ Real-Time Chat System

Enable communication between donors and NGOs.

๐Ÿ“ Location-Based NGO Recommendations

Recommend nearby NGOs for quicker food distribution.

๐Ÿšš Pickup Scheduling

Allow donors and NGOs to schedule pickup timings.

๐Ÿ”” Real-Time Notifications

Instant updates for donation status and approvals.

๐Ÿ“Š Analytics Dashboard

Track donations, NGO activities, and platform impact.

๐Ÿ“ง Email Verification

Implement email OTP verification during registration.

๐ŸŒ Multi-Language Support

Support regional and international languages.

๐Ÿค Volunteer Management

Enable volunteers to participate in food collection and delivery.


๐ŸŒ Impact

ShareBowl helps reduce food wastage by connecting food donors with verified NGOs through a transparent and efficient platform. The application promotes sustainable food distribution and contributes to community welfare by ensuring that surplus food reaches those who need it most.


๐Ÿ‘จโ€๐Ÿ’ป Author


โญ Support

If you found this project useful, please consider giving it a star on GitHub!

About

A full-stack MERN web application that connects food and grocery donors with NGOs, enabling efficient donation management and helping reduce waste while supporting communities in need

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages