dkay9/nigeria-economy-pulse
Domain:
socioeconomicRecord type:
software
Creator:
dka
Host:
# Nigeria Economic Pulse
Interactive economic data dashboard for Nigeria, built with D3.js and Next.js.
## Data Sources
| Source | Access Method | Coverage | Update Frequency |
|--------|--------------|----------|-----------------|
| **World Bank API** | REST API (no key) | GDP, inflation, exchange rate, unemployment, trade balance, oil rents | ~Annual (lags 1-2 years) |
| **NBS (static)** | Curated JSON snapshots | GDP by sector, state-level GDP contribution, poverty rates | Manual (from NBS reports) |
| **CBN (static)** | Curated JSON snapshots | Supplementary data if needed | Manual (from CBN bulletins) |
| **geoBoundaries** | Downloaded GeoJSON | Nigeria state polygons (36 + FCT) | Static (boundaries stable) |
### Important Data Caveats
- **World Bank data typically lags 1-2 years.** The most recent data point may be from 2023 or 2024, not the current year. The dashboard displays the actual period for each metric.
- **State-level GDP figures are estimates.** Nigeria does not publish official state GDP annually. The figures in `static-datasets.ts` are compiled from various NBS publications and should be treated as indicative.
- **Poverty data is from the 2022 NBS survey.** Methodology and coverage vary between surveys.
- **Static data must be manually updated** when NBS/CBN publish new reports. Check `snapshotDate` in each dataset.
## Setup
```bash
# Install dependencies
npm install
# Download GeoJSON (runs automatically via postinstall, or manually):
npm run setup:geo
# Start dev server
npm run dev
```
## Architecture
```
src/
├── app/
│ └── api/
│ ├── indicators/route.ts # World Bank proxy + normalization
│ └── geo/route.ts # GeoJSON server
├── lib/
│ ├── world-bank.ts # World Bank API client
│ ├── data-fetcher.ts # Unified data layer (source priority)
│ └── d3-theme.ts # Shared D3 visual constants
├── data/
│ └── static-datasets.ts # NBS/CBN curated snapshots
├── types/
│ …