Skip to content

Sina-Majd/MacroDash

Repository files navigation

MacroDash

MacroDash is a client-only macroeconomic dashboard built with React + TypeScript that visualizes World Bank Open Data. Explore long-run trends, compare countries, and export clean CSVs for analysis. No backend required.

MacroDash macroeconomic dashboard desktop preview MacroDash macroeconomic dashboard mobile preview

Highlights

  • Country search, favorites, and last-viewed shortcuts
  • KPI cards for GDP, GDP per capita, inflation, and unemployment
  • Compare view with shareable URLs (2-6 countries)
  • CSV export for charts and tables
  • IndexedDB cache with 12-hour TTL and stale-while-revalidate
  • Route-level error boundaries and basic unit tests

Use cases

  • Macro research and country benchmarking
  • Class projects, policy briefs, and economic dashboards
  • Data visualization demos using open data

Data sources

Indicators emphasized in the UI include GDP, GDP per capita, inflation (CPI), and unemployment. Coverage varies by country and series.

Tech stack

  • React + TypeScript
  • React Router v7 data router
  • Recharts for charts
  • idb-keyval for caching
  • Tailwind CSS v4 + Vite

Getting started

bun install
bun run dev

The app runs at http://localhost:5173.

Scripts

bun run dev
bun run build
bun run start
bun run typecheck
bun run test

Deployment

This project runs in SPA mode and can be hosted on any static hosting provider. Run bun run build and deploy the output.

Notes

Data coverage varies by indicator and country. Missing values are shown as N/A and cached data is displayed while fresh data loads in the background.

About

A macroeconomic dashboard built with React and React Router v7 to visualize and compare global financial indicators using World Bank data.

Topics

Resources

Stars

Watchers

Forks

Contributors