declerke/Kenya-Pulse

# 🇰🇪 KenyaPulse: Economic & Development Intelligence Dashboard **KenyaPulse** is a production-grade, interactive data analytics dashboard that transforms raw World Bank Open Data into a compelling, decision-ready intelligence platform. It tracks **14 macroeconomic and social indicators** for Kenya across 25 years, benchmarked against 6 African peer nations, and delivers live insights through a fully containerised Streamlit application. --- ## 🎯 Project Goal To build a self-contained analytics platform that demonstrates the full spectrum of data storytelling — from automated API ingestion and in-memory caching to interactive multi-page visualisation — using Kenya's real economic and social development data as the subject domain. --- ## 🧬 System Architecture The dashboard follows a modular **Fetch → Cache → Visualise** pattern: 1. **Data Ingestion:** Python-based polling of the **World Bank Open Data API** (no authentication required) for indicators across economic, social, and infrastructure categories. 2. **Caching Layer:** `@st.cache_data` with a 1-hour TTL prevents redundant API calls on every page interaction, improving responsiveness and reducing external load. 3. **Transformation Layer:** `pandas` DataFrames handle date filtering, null-value removal, unit conversion (e.g., GDP in billions), and min-max normalisation for the radar chart. 4. **Visualisation Layer:** `Plotly` renders 10+ interactive chart types (line, area, bar, donut, multi-line, horizontal bar, radar) with consistent Kenya-themed styling. 5. **Multi-page App:** Streamlit's native page routing organises the dashboard into four focused sections. 6. **Containerisation:** Docker Compose packages the full app into a single portable service. --- ## 📊 Dashboard Sections | Page | Content | | :--- | :--- | | **🏠 Overview** | 6 live KPI metric cards, Kenya narrative, section navigation | | **💹 Economic Indicators** | GDP, GDP Growth, GDP Per Capita, Inflation, Trade (% GDP), FDI | | **👥 Social In …