Skip to content

itsgaspr/moz-indicators

Repository files navigation

🗺️ Moz Demographic Indicators

An interactive dashboard for exploring Mozambique's demographic data across time.

React JavaScript REST API

Live Demo · API Docs · Report Bug


📖 Overview

Moz Demographic Indicators is a web application that brings Mozambique's demographic statistics to life through a clean, year-by-year dashboard. Users can explore key indicators ranging from population and urbanization to health metrics, all sourced from official national data.


✨ Features

Feature Description
📅 Year Selector Browse demographic data from 2017 to 2026
👥 Population Total population with male/female breakdown and sex ratio
🏙️ Urbanization Urban population rate, growth rate, and dependency ratio
🩺 Health & Age Median age, life expectancy, and infant mortality rate
💚 Health Monitor Live service status and uptime display

🛠️ Tech Stack

Frontend

  • React.js — component-based UI with reactive state management for seamless year selection and dynamic data rendering
  • JavaScript (ES6+) — modern application logic, async data fetching, and DOM interactions
  • CSS3 — responsive card layout and clean visual design

Data Layer

  • REST API — all demographic data is consumed from the moz-demog-api over standard HTTP/JSON endpoints
  • JSON — lightweight data exchange format between the API and the frontend

📡 Data Source

Demographic statistics are sourced from the INE — Instituto Nacional de Estatísticas de Moçambique, the official national body responsible for collecting and publishing Mozambican statistical data.

These statistics are exposed through moz-demog-api, a purpose-built REST API developed and maintained by the author of this project.

moz-demog-api provides structured, versioned access to Mozambican demographic data, making it easy to integrate into any application.


🚀 Usage

  1. Open the application in your browser
  2. Use the year selector to pick any year between 2017 and 2026
  3. The dashboard automatically fetches and displays the corresponding indicators

👤 Author

Built with 🖤 by therakius — developer of both this dashboard and the underlying moz-demog-api.


📄 License

© 2026 therakius. All rights reserved.

About

An interactive React dashboard for exploring Mozambique's demographic indicators — population, urbanization, and age statistics from 2017 to 2026, with real-time API health monitoring. Built on top of moz-demog-api, powered by official INE data.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors