tolulawson/ndhs-explorer

nteractive data explorer for the Nigeria Demographic and Health Survey (NDHS) 2024, featuring visualizations of key health, population, and demographic indicators across all 19 chapters. # NDHS Explorer Interactive data explorer for the **Nigeria Demographic and Health Survey (NDHS) 2024**. This application provides visual access to key health indicators from all 19 chapters of the official DHS report. ## Features - **19 Chapters** of comprehensive health data covering: - Population & Housing - Fertility & Family Planning - Maternal & Child Health - Nutrition & Malaria - HIV/AIDS Knowledge - Women's Empowerment - WASH & more - **Interactive Charts** - Bar, line, and pie charts powered by Recharts - **Responsive Design** - Works on desktop and mobile devices - **Fast Navigation** - Built with TanStack Router for client-side routing ## Tech Stack - TanStack Start - Full-stack React framework - TanStack Router - Type-safe routing - Recharts - Composable charting library - Tailwind CSS - Utility-first CSS - Bun - JavaScript runtime & package manager ## Getting Started ### Prerequisites - Bun v1.0 or higher ### Installation ```bash # Clone the repository git clone github.com cd ndhs-explorer # Install dependencies bun install # Start development server bun run dev ``` The app will be available at `localhost`. ### Build for Production ```bash bun run build bun run preview ``` ## Project Structure ``` src/ ├── components/ # Reusable UI components │ ├── ChartRenderer.tsx │ ├── Icon.tsx │ └── Sidebar.tsx ├── data/ │ └── chapters/ # JSON data files organized by chapter │ ├── 1/ │ │ ├── metadata.json │ │ └── survey-response-rates.json │ ├── 2/ │ └── ... ├── lib/ │ └── chapters.ts # Data loading utilities ├── routes/ │ ├── __root.tsx # Root layout with sidebar │ ├── index.tsx # Landing page │ └── chapter.$id.tsx # Dynamic chapter route └── styles.css ``` ## Data Source All data is sourced from the Nigeria DHS 2024 Final Report, published by the National Population Commission (NPC), Federal Ministry of Health (FMOH), with sup …