A intelligent platform connecting food surplus from canteens with users in need, reducing food waste while supporting communities.
FoodWise is a smart food redistribution platform that enables canteens and food establishments to share surplus food with users in need. By connecting food donors with recipients in real-time, we reduce food waste and combat food insecurity.
- 📉 Reduce food waste from canteens and establishments
- 🤝 Connect surplus food with people in need
- 📊 Track food redistribution metrics
- ⏰ Prevent food spoilage with pickup time management
- ✅ Post surplus food listings with details (name, quantity, location)
- ✅ Set pickup times for fresh food distribution
- ✅ Track claimed food items
- ✅ Monitor redistribution statistics
- 🔒 Secure authentication with email/password
- ✅ Browse available food listings in real-time
- ✅ Claim food items for pickup
- ✅ View food details (quantity, location, pickup time)
- 🔒 Secure authentication with email/password
- ✅ Password recovery options
- 📊 Real-time stats dashboard
- 🔄 Automatic expiration handling
- 📱 Responsive web interface
- 🔐 Firebase authentication & Firestore database
| Layer | Technology |
|---|---|
| Frontend | HTML5, CSS3, JavaScript (Vanilla) |
| Backend | Node.js + Express.js |
| Database | Firebase Firestore |
| Authentication | Firebase Auth |
| Nodemailer | |
| Styling | Tailwind CSS |
smart-food-redistribution-FoodWise/
├── public/ # Static frontend files
│ ├── index.html # Main entry point
│ ├── canteen/ # Canteen UI
│ │ ├── canteen-login.html # Canteen login page
│ │ ├── canteen-login.css # Canteen login styles
│ │ ├── canteen-dashboard.html # Canteen dashboard
│ │ └── reset-pass-canteen.html # Password reset
│ └── user/ # User UI
│ ├── user-login.html # User login page
│ ├── user-login.css # User login styles
│ ├── user-dashboard.html # User dashboard
│ └── reset-pass-user.html # Password reset
│
├── src/ # Source code
│ ├── app/ # Application logic
│ │ ├── canteen-app.js # Canteen JavaScript
│ │ ├── user-app.js # User JavaScript
│ │ ├── canteen-login.js # Canteen login handler
│ │ └── user-login.js # User login handler
│ └── config/ # Configuration
│ ├── firebaseconfig.js # Firebase setup
│ └── serviceAccountKey.json # Firebase service account
│
├── server/ # Backend server
│ └── server.js # Express server & API
│
├── package.json # Dependencies
├── .env # Environment variables
└── README.md # This file
- Node.js v16+ and npm/yarn
- Git for version control
- Firebase Account with Firestore & Authentication enabled
- Firebase Service Account Key (for admin operations)
- Modern web browser (Chrome, Firefox, Safari, Edge)
git clone <repository-url>
cd smart-food-redistribution-FoodWisenpm install- Go to Firebase Console
- Create a new project or use existing one
- Enable Firestore Database and Authentication (Email/Password)
- Download your Firebase Admin SDK private key (JSON)
- Save it as
src/config/serviceAccountKey.json
Create a .env file in the root directory:
# Firebase Configuration
SERVICE_ACCOUNT_JSON={"type":"service_account",...}
# OR use with the JSON file directly
GOOGLE_APPLICATION_CREDENTIALS=./src/config/serviceAccountKey.json
# Server Configuration
PORT=3000
NODE_ENV=development
# Email Configuration (Optional - for password reset)
EMAIL_USER=your-email@gmail.com
EMAIL_PASSWORD=your-app-passwordnpm run dev- Backend runs on
http://localhost:3000 - Frontend can be served via Live Server or Python
npm start# Using Python 3
cd public
python3 -m http.server 8000
# Using Python 2
python -m SimpleHTTPServer 8000
# Visit http://localhost:8000http://localhost:3000/api
GET /api/healthResponse:
{ "status": "ok" }POST /api/food
Content-Type: application/json
{
"foodName": "Leftover Pizza",
"quantity": "5 slices",
"location": "Main Canteen, Building A",
"pickupTime": "2026-05-16T18:00:00Z",
"postedBy": "canteen-user@example.com"
}GET /api/foodResponse:
[
{
"id": "food123",
"foodName": "Leftover Pizza",
"quantity": "5 slices",
"location": "Main Canteen",
"pickupTime": "2026-05-16T18:00:00Z",
"status": "available",
"postedBy": "canteen@example.com",
"createdAt": "2026-05-16T12:00:00Z"
}
]POST /api/food/:id/claim
Content-Type: application/json
{
"claimedBy": "user@example.com"
}GET /api/statsResponse:
{
"totalListings": 42,
"availableListings": 15,
"claimedListings": 20,
"expiredListings": 7,
"totalQuantity": "150 items"
}POST /api/expireAutomatically marks expired listings based on pickupTime.
{
"id": "food_12345",
"foodName": "string",
"quantity": "string",
"location": "string",
"pickupTime": "timestamp",
"status": "available | claimed | expired",
"postedBy": "string (email)",
"createdAt": "timestamp",
"claimedBy": "string | null (email)",
"claimedAt": "timestamp | null",
"expiresAt": "timestamp"
}{
"uid": "firebase-uid",
"email": "string",
"displayName": "string",
"role": "canteen | user",
"createdAt": "timestamp",
"lastLogin": "timestamp"
}| Variable | Description | Required |
|---|---|---|
SERVICE_ACCOUNT_JSON |
Firebase service account JSON | ✅ |
GOOGLE_APPLICATION_CREDENTIALS |
Path to service account file | ✅ (if not using above) |
PORT |
Server port | ❌ (default: 3000) |
NODE_ENV |
Environment type | ❌ (default: development) |
EMAIL_USER |
Email for password reset | ❌ |
EMAIL_PASSWORD |
Email app password | ❌ |
We welcome contributions! Here's how:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
- Use consistent naming conventions
- Add comments for complex logic
- Test before submitting PR
- Update documentation
This project is licensed under the MIT License - see LICENSE file for details.