Cleanify

Cleanify is a smart waste-management platform that connects IoT-enabled bins, an optimized route-dispatch engine, a real-time admin dashboard, and a driver mobile app into one system. Live at cleanify.live.

Landing page - cleanify.live

Admin dashboard - cleanify.live/dashboard

Screenshots

Project structure

cleanify-new/
├── admin_backend/        Flask + PostgreSQL + SocketIO API, OR-Tools route optimizer
├── admin_dashboard/       React + TypeScript + Vite admin web app
├── cleanify_driver_app/   Flutter driver mobile app (Android/iOS)
└── media/       Image assets used in this README

Component	Stack	README
Backend API	Flask, PostgreSQL, SocketIO, OR-Tools, XGBoost	admin_backend/README.md
Admin Dashboard	React 19, TypeScript, Vite, MUI, Leaflet	admin_dashboard/README.md
Driver App	Flutter, Provider, flutter_map, Geolocator	cleanify_driver_app/README.md

Architecture

┌──────────────────┐      REST + WebSocket      ┌───────────────────┐
│  Admin Dashboard │ ◄────────────────────────► │                   │
│  (React/Vite)    │                            │   admin_backend   │
└──────────────────┘                            │  (Flask + Socket  │
                                                 │   IO + OR-Tools)  │
┌──────────────────┐      REST + WebSocket      │                   │
│  Driver App       │ ◄───────────────────────► │   PostgreSQL DB   │
│  (Flutter)        │                            └───────────────────┘
└──────────────────┘

• The dashboard manages trucks, drivers, bins, depots, routes, alerts and IoT gateways, and watches live truck movement on the map.
• The backend exposes the REST API, broadcasts live events over SocketIO (truck:location, bins:updated, alert:new, ...), and runs the OR-Tools route optimizer plus the fill-level/traffic ML models.
• The driver app receives the day's optimized route, logs collections, and streams GPS location back to the backend for the dashboard's live map.

Getting started

Each component has its own setup instructions:

1. Backend - admin_backend/README.md
2. Dashboard - admin_dashboard/README.md
3. Driver app - cleanify_driver_app/README.md

Typical local order: start PostgreSQL → run the backend (http://localhost:5002) → run the dashboard (npm run dev) → run the driver app pointed at the backend.

Live deployment

• Landing page: cleanify.live
• Admin dashboard: cleanify.live/dashboard