CIA World Factbook - Modern UI with Most Current Data

A high-performance, minimalist, and visual-first interface for the CIA World Factbook's most current data before being shut.

Features

• Modern Minimalist UI: Built with React and TypeScript, optimized for readability and aesthetics.
• Interactive Visuals: Includes country flags, locator maps, and detailed political maps with a zoomable image viewer.
• Travel Insights: Integrated "Travel Facts" section with direct PDF access.
• Dark Mode Support: Fully responsive dark and light themes.
• Local-First Search: Instant search across all countries and regions.

Tech Stack

• Frontend: React 19, Vite
• Styling: Vanilla CSS with modern variables and glassmorphism
• Data Engineering: Python-based data processing script

Getting Started

Prerequisites

• Node.js 20+
• npm

Installation

npm install

Development

npm run dev

Build for Production

npm run build

The site is configured for automatic deployment to GitHub Pages via GitHub Actions.

Data Processing

The project includes a process_data.py script that handles the conversion of raw Factbook JSON files into a flat directory structure optimized for web loading. It also maps asset paths for flags, maps, and travel PDFs.

Data Sources

The information and visual assets for this project are provided by the following open-source repositories:

• JSON Data: factbook/factbook.json
• Visual Assets & PDFs: simonw/cia-world-factbook-2020

License

Public Domain (based on CIA World Factbook data)