AI-Powered Surplus Matching & Relief Redistribution System
SurplusSync bridges the gap between excess resources (from restaurants, events, and businesses) and local NGOs or community relief centers in real-time. Powered by smart location indexing and natural language processing, SurplusSync ensures usable surplus reaches those who need it most—fast, transparent, and hassle-free.
| 1. AI Match & Coordination Screen | 2. Real-Time Command Center |
|---|---|
 |
 |
- 🤖 Smart Natural Language Parsing: Extracts resource categories, shelf-life, and urgency directly from unformatted plain text descriptions using Google Gemini API.
- 📍 Dynamic Proximity & Urgency Scoring: Evaluates location inputs (e.g., Tirupati regional hubs) and priority levels to calculate high-confidence match scores (up to 97.8%).
- ⚡ Dual Action Portals:
- Donate Surplus: Allows local businesses and event organizers to report surplus items, location, and pickup timeframes quickly.
- Request Resources: Enables NGOs and community shelters to broadcast urgent supply needs in real time.
- 📊 Live Command Center: Dynamic dashboard providing real-time tracking of active donations, fulfilled matches, and community impact metrics.
- 🤝 Instant Coordination Workflow: Seamless match acceptance triggers delivery coordination and verification tokens for volunteer courier networks.
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ DONOR PORTAL │ ───► │ AI MATCH ENGINE│ ───► │ NGO REQUEST │ │ Surplus Details │ │ Context & Rank │ │ Real-time Match │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ ▼ ┌─────────────────┐ │ COMMAND CENTER │ │ Impact Tracking │ └─────────────────┘
| Layer | Technology | Purpose |
|---|---|---|
| Frontend UI | HTML5, Modern CSS, Vanilla JavaScript (ES6+) | Lightning-fast, dependency-light SPA interface |
| Build System | Vite | Rapid development server and bundling |
| Server Engine | Node.js + Express.js | REST API routing and middleware |
| Database | MongoDB Atlas | Cloud document storage for donors, NGOs, and match logs |
| Intelligence | Google Gemini API | Automated entity extraction & context-aware match scoring |
Follow this sequence to test the complete user loop in under a minute:
- Click Donate Surplus
$\rightarrow$ Enter Organization:Green Bowl Kitchen, Location:Tirupati, Description:Prepared meals for 40 people. - Click Find Matching NGO
$\rightarrow$ Automatically routes to the Request Resources portal. - Enter Request Details
$\rightarrow$ Click Find Matching Donor. - Review the generated 96.4% Match Strength Card with courier timing.
- Click Accept match & coordinate to confirm the alert modal and route straight to the Live Command Center!
git clone [https://github.com/chandini31-hub/SurplusSync.git](https://github.com/chandini31-hub/SurplusSync.git)
cd SurplusSyncnpm install
cd surplusync-backend npm install cd ..
PORT=5000 MONGO_URI=your_mongodb_atlas_connection_string GEMINI_API_KEY=your_google_gemini_api_key_here
cd surplusync-backend
node server.js
npm run dev
MIT License
Copyright (c) 2026 SurplusSync
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.