BobGichuru/cleanwater-app

A Next.js & Firebase platform to digitize and optimize water delivery in Kenya, featuring AI-powered dispatch and role-based portals. # CleanWater.ke ### Taming Nairobi's Water Chaos, One Bowser at a Time. Urban water logistics are fundamentally a problem of information asymmetry. When municipal taps run dry, a fragmented, informal market of private vendors emerges, but it operates with near-zero transparency. We decided to solve for *x*. CleanWater.ke is a digital aqueduct for modern Nairobi; a multi-portal system designed to connect water-scarce customers with a fleet of vetted, professional water vendors. It's less an "app" and more a managed ecosystem for urban logistics. --- ## Core Architecture & User Experience Our system is built on the principle of segregated interfaces; no single user is burdened with features irrelevant to their role. * Four Portals to Rule Them All; separate, tailored experiences for **Customers**, **Drivers**, **Vendor/Owners**, and the all-powerful **Admins**. This isn't just a UI choice, it's an architectural one that prevents feature-bloat and cognitive overload. * An All-Seeing AI Dispatcher; a Genkit-powered logistics engine that doesn't just find the *closest* driver, it finds the *best* driver by weighing a vendor's historical quality rating against a driver's real-time ETA. It's a logistics genius in your pocket `(ツ)`. * A Platform for Water Barons; the system is designed for scale. Vendors can manage entire fleets of drivers, track earnings granularly, and expand their operation from a single truck to a water empire. * Incentivized Quality; high ratings aren't just for show. Top-performing vendors unlock access to platform loans with automated repayments per trip. We're investing in quality, not just participation. * Real-Time Telemetry (No More Guesswork); watch your water bowser snake through Nairobi traffic right on your screen. You'll know precisely when it's arriving. * Fort Knox Security; with Firebase Auth handling roles and secure, segregated wallets for every user, your data and earnings are locked down tight. ## The Technica …