Skip to content

We are a team of 2 building a Food Rescue App where restaurants can donate leftover food to NGOs. It includes food listing, pickup status, and location tracking using Node.js, Express, MongoDB, and React with a clean, functional UI.

Notifications You must be signed in to change notification settings

Keerthims13/Food-Rescue-App

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🍱 Food Rescue App

A full-stack web application that connects restaurants and individuals with surplus food to people in need. The platform allows donors to list excess food, and volunteers can request pickups to redistribute it.


πŸ“Œ Project Overview

Goal: To reduce food waste and fight hunger by building a seamless, user-friendly interface for food donations and pickups.

Tech Stack:

  • Frontend: Next.js, TypeScript, Tailwind CSS, Axios
  • Backend: Node.js, Express.js, MongoDB (Mongoose)
  • API Design: RESTful endpoints
  • Styling: Lucide Icons, Tailwind gradients, modern UI components

🌟 Features

πŸ”Ό Donor Side

  • Submit donation details (restaurant name, food type, quantity, location, contact)
  • View past donations in History
  • Responsive and mobile-friendly UI

πŸ‘€ Volunteer Side

  • Browse available food donations
  • Click "Request Pickup" to mark food as picked up
  • Filter out already picked up donations

🧠 Folder Structure

Food-Rescue-App/ β”œβ”€β”€ backend/ β”‚ β”œβ”€β”€ models/ β”‚ β”‚ └── FoodItem.js β”‚ β”œβ”€β”€ routes/ β”‚ β”‚ └── foodRoutes.js β”‚ └── server.js β”œβ”€β”€ frontend/ β”‚ └── app/ β”‚ β”œβ”€β”€ browse/ β”‚ β”œβ”€β”€ donate/ β”‚ β”œβ”€β”€ history/ β”‚ β”œβ”€β”€ components/ β”‚ β”‚ β”œβ”€β”€ AddDonationForm.tsx β”‚ β”‚ └── DonationCard.tsx


πŸ” API Endpoints

Base URL: http://localhost:5000/api/food

Method Endpoint Description
GET / Fetch all donations
POST / Create a new food donation
PATCH /:id/pickup Mark a donation as picked up

Uses Mongoose validation and error handling


πŸ› οΈ How to Run Locally

πŸ“¦ Backend

cd backend
npm install
node server.js


## Frontend

cd frontend
npm install
npm run dev


πŸ§ͺ Testing Data

{
  "restaurantName": "Green Bites",
  "foodType": "Vegetarian Rice",
  "quantity": "20 meals",
  "location": "MG Road, Bangalore",
  "phone": "9876543210"
}


πŸ“· Screenshots
πŸ“€ Donate Page	πŸ“₯ Browse Page	πŸ“œ History Page

<p align="center">
  <img src="![alt text](image.png)" alt="Food Rescue App Screenshot" width="200"/>
   <img src="![alt text](image.png)" alt="Food Rescue App Screenshot" width="200"/>
    <img src="![alt text](image.png)" alt="Food Rescue App Screenshot" width="200"/>
</p>




πŸ’Ό Why This Project Matters
Showcases full-stack skills (CRUD, REST APIs, state management)

Addresses real-world problem (food waste)

Clean, production-level code with professional UI/UX

Prepared to extend with authentication, maps, notifications, etc.

✨ Future Enhancements
User login system (Admin/Volunteer)

Pickup location map integration (Google Maps)

Notifications to NGOs

Food expiry handling

πŸ‘¨β€πŸ’» Developer
Maneesh Kumar
MCA | Full-Stack Developer | Passionate about impactful software
LinkedIn | GitHub


πŸ“„ License
This is a student project for learning purposes. Not intended for production or open-source reuse.



About

We are a team of 2 building a Food Rescue App where restaurants can donate leftover food to NGOs. It includes food listing, pickup status, and location tracking using Node.js, Express, MongoDB, and React with a clean, functional UI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 89.2%
  • JavaScript 9.4%
  • CSS 1.4%