Skip to content

YashDhavale/CSC-510-SE-Project

CSC-510-SE-Project

TiffinTrails

Contributors DOI Python Version Last Commit Issues License Forks Discussions Open PRs License Contributor Covenant Contributing Install Python Node.js React CSV Code Style: Black Linted with Flake8 Formatted with Prettier ESLint Status Code Style: Black Linted with Flake8 Formatted with Prettier ESLint Status Coverage CodeQL

πŸ₯— TiffinTrails

Rescuing Surplus Food, Empowering Communities

TiffinTrails connects local restaurants with eco-conscious customers to rescue surplus meals that would otherwise go to waste. Our platform enables users to order these discounted β€œrescue meals,” reducing food waste, carbon emissions, and hunger β€” all while supporting local businesses.

πŸš€ Our Mission

Every year, millions of tons of food go uneaten while countless people face food insecurity. Restaurants often discard perfectly edible meals due to overproduction or changing demand. TiffinTrails bridges this gap β€” giving unsold meals a second chance and making sustainability accessible to everyone.

We envision a world where no good food goes to waste and every meal contributes to a healthier planet 🌍.

🧠 How It Works

  1. Discover Local Restaurants – Browse partner restaurants offering surplus meals near you.
  2. Order Rescue Meals – Choose discounted, ready-to-eat surplus meals.
  3. Track Your Impact – See how much waste you’ve helped prevent and meals you’ve rescued.
  4. Support Local Businesses – Every rescue helps small restaurants thrive sustainably.

πŸ’‘ Impact

  1. Customers: Access affordable meals while reducing your carbon footprint.
  2. Restaurants: Monetize surplus food instead of wasting it.
  3. Communities: Strengthen local connections and fight food insecurity.
  4. Planet: Lower food waste and greenhouse gas emissions.

🎯 Target Users

TiffinTrails is designed for:

  1. 🌱 Eco-conscious consumers who want to make sustainable meal choices.

  2. 🍴 Restaurants aiming to minimize food waste and improve profitability.

  3. πŸ™οΈ Local communities that value circular, sustainable ecosystems.

  4. 🀝 NGOs & food recovery organizations supporting social impact initiatives.

πŸ—“οΈ Development Roadmap

October – Release 1: MVP

  1. Build authentication flow (Signup, Login, Logout).

  2. Develop the Home page with live statistics from food waste data (meals rescued, waste prevented, active users).

  3. Build backend APIs to fetch restaurant listings and calculate impact metrics.

  4. Integrate a simple ordering flow using CSV data simulation.

  5. November – Release 2: Enhanced Features

  6. Implement dynamic dashboard with real-time updates when users order meals.

  7. Add filtering, sorting, and restaurant categorization (by cuisine/type).

  8. Include analytics charts showing total rescued meals and waste prevented over time.

  9. Introduce leaderboard or rewards system for top contributors.

🧩 Third-Party Dependencies

The following table lists all external dependencies used in TiffinTrails, including version numbers, usage type (mandatory/optional/dev), and license information.

Frontend (React.js)

Package Version Type License Homepage / Source
react 19.0.0 Mandatory MIT react.dev
react-dom 19.0.0 Mandatory MIT react.dev/reference/react-dom
tailwindcss 3.4.10 Optional MIT tailwindcss.com
lucide-react 0.545.0 Mandatory ISC lucide.dev
shadcn/ui latest Optional MIT ui.shadcn.com

Backend (Node.js / Express.js)

Package Version Type License Homepage / Source
express 4.19.2 Mandatory MIT expressjs.com
cors 2.8.5 Mandatory MIT github.com/expressjs/cors
csv-parser 3.0.0 Mandatory MIT npmjs.com/package/csv-parser
dotenv 16.4.5 Optional BSD-2-Clause npmjs.com/package/dotenv
nodemon 3.1.4 Dev Dependency MIT nodemon.io

Data Analytics (Python)

Package Version Type License Homepage / Source
pandas 2.2.2 Mandatory BSD-3-Clause pandas.pydata.org
numpy 1.26.4 Mandatory BSD-3-Clause numpy.org
matplotlib 3.9.2 Optional PSF matplotlib.org
openpyxl 3.1.5 Optional MIT openpyxl.readthedocs.io
python-dotenv 1.0.1 Optional BSD-3-Clause pypi.org/project/python-dotenv

πŸ§ͺ Example Use Cases πŸ₯‘ Customer Use Case

A user orders a β€œrescue meal” from a nearby restaurant and instantly sees their positive impact β€” meals saved and waste prevented β€” updated in real time.

πŸͺ Restaurant Use Case

A restaurant uploads surplus meals at the end of the day, converting potential waste into revenue and goodwill.

🌍 Community Impact Use Case

The system aggregates all users’ orders to display total meals rescued and tons of waste prevented on the homepage.

Tiffin_Trails_Demo.4.mov

About

Food waste and inefficient delivery remain major challenges for restaurants and food platforms, increasing costs and environmental impact. TiffinTrails tackles this through a data-driven, reward-based system that tracks delivery efficiency, waste reduction, and sustainability.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors