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 …