MealBridge

MealBridge is a role-based Surplus Food Redistribution platform for the UN SDG 2 problem statement.

What is now hackathon-ready

• Role-first login flow for Hotel, NGO, Delivery, and Admin
• Different dashboards for each role
• Quote-based loading screen after login
• Session persistence, so refresh does not log you out mid-session
• Local demo mode for single-browser use
• Optional Supabase-backed shared data mode
• Realtime-ready NGO requests, hotel batches, dispatch, pickup, and delivery updates
• Admin reset for demo data

Core rescue flow

1. NGO raises a food request based on real beneficiary need.
2. Hotel publishes a safe surplus batch.
3. NGO or Admin matches supply to demand.
4. NGO or Admin dispatches delivery.
5. Delivery marks pickup and delivery.
6. Activity feed and metrics update across the platform.

Demo logins

• Hotel: hotel / hotel
• NGO: ngo / ngo
• Delivery: delivery / delivery
• Admin: admin / admin

Local run

cd d:\Projects\surplus-food-platform
python -m http.server 8000

Then open http://localhost:8000.

Supabase setup for realtime

1. Create a Supabase project.
2. Open the SQL editor and run supabase-schema.sql.
3. Copy your project URL and anon or publishable key.
4. Open the app login page and paste them into the Realtime setup form.
5. Click Enable Realtime.

After that, multiple browsers or devices connected to the same project will share the same requests, batches, delivery updates, and activity feed.

Architecture

Role Login -> Hotel Supply / NGO Demand / Delivery Dispatch -> Supabase Live Hub -> Shared Activity + Admin Oversight

Important note

This is intentionally a hackathon-grade architecture:

• Role credentials are still fixed demo credentials
• Supabase Auth is not implemented yet
• Data permissions are open for easier judging/demo flow

That is enough for a strong 70% prototype. The 100% version would add real user accounts, protected policies, notifications, maps, and deployment.