A real-time flood monitoring and early warning platform built for Kenyan urban centres
# π Kenya Flash Flood Early Warning System (FFEWS)
A **real-time flood monitoring and early warning platform** built for Kenyan urban centres. The system combines live weather data, hydrological modelling (SCS-CN method), and community reporting to deliver actionable flood risk assessments and alerts.
> **Live Data** β Every metric on this dashboard is pulled from real-time weather APIs. No hardcoded or simulated data.
---
## β¨ Features
| Feature | Description |
|---|---|
| **Real-Time Dashboard** | Live flood risk scores, precipitation charts, active alerts, and weather conditions |
| **Interactive Flood Map** | Leaflet-based map with flood zone overlays, safe zones, evacuation routes, and weather stations |
| **Smart Alert System** | Auto-generated alerts based on real weather conditions β EMERGENCY, WARNING, WATCH, INFO levels |
| **Weather Monitoring** | City-by-city weather data with hourly forecasts for 8 Kenyan cities |
| **Community Reports** | Crowdsourced flood reports with verification workflow |
| **Evacuation Routes** | Pre-defined safe zones with capacity info and distance calculations |
| **Historical Analytics** | Real precipitation trends, monthly aggregation, and zone risk rankings |
| **Flood Risk Engine** | SCS Curve Number method with imperviousness weighting and Antecedent Moisture Condition (AMC) adjustments |
---
## ποΈ Architecture
```
Kenya-Flood-Alert-System/
βββ app-build/ # Next.js application
β βββ src/
β β βββ app/
β β β βββ page.js # Dashboard
β β β βββ alerts/ # Alert management
β β β βββ analytics/ # Historical analytics
β β β βββ community/ # Community reports
β β β βββ evacuation/ # Evacuation routes
β β β βββ map/ # Interactive flood map
β β β βββ weather/ # Weather monitoring
β β β βββ api/
β β β βββ alerts/ # Alert generation API
β β β βββ f β¦