Surplus Share: Connecting Excess to Need

Surplus Share is an innovative application designed to bridge the gap between businesses with surplus food and individuals in need. Utilizing an advanced heuristic genetic algorithm, the app optimizes delivery routes for drivers, ensuring the swift and efficient distribution of food. It also incorporates a sophisticated distribution algorithm, taking into account various factors such as dietary restrictions to facilitate the most effective allocation of food resources.

1st Place Winner at SHS Hacks 2024

Watch the demo here!

Getting Started

Frontend Setup

Run the following commands to install the required packages and start the frontend server.

cd frontend
npm install
npm run dev

Backend Setup

Run the following commands to install the required packages and start the backend server.

cd backend
pip install -r requirements.txt
python app.py

By following these instructions, you'll have both the frontend and backend of Surplus Share up and running, ready to connect surplus food with those who need it most.