How It Works
From GitHub to Fantasy World in 5 Steps
Git Kingdom reads public data from GitHub and transforms it into a living pixel-art fantasy world. Here's exactly how that mapping works.
Languages Become Kingdoms
Each programming language in the GitHub ecosystem becomes its own kingdom — a distinct city in the world map. TypeScript, Python, Rust, Go, Java — each has its own territory with unique buildings and citizens. The more popular the language, the larger and busier its kingdom.
Repos Become Buildings
Every public GitHub repository with at least 1 star becomes a building in its language's kingdom. The number of stars a repo has determines the building's size and rank — from small hovels to towering citadels.
Stars Determine Building Size
GitHub stars are the currency of the kingdom. More stars = bigger building. Here's the full ranking system:
| Rank | Stars | Size | |
|---|---|---|---|
| 🛖 | Hovel | 1 – 20 | 2×2 |
| 🏠 | Cottage | 21 – 100 | 3×3 |
| 🏡 | House | 101 – 500 | 4×4 |
| 🏢 | Hall | 501 – 1,000 | 5×5 |
| 🏛️ | Manor | 1,001 – 5,000 | 7×7 |
| 🏰 | Keep | 5,001 – 20,000 | 9×9 |
| 🏯 | Castle | 20,001 – 50,000 | 12×12 |
| ⛪ | Fortress | 50,001 – 100,000 | 16×16 |
| 👑 | Citadel | 100,000+ | 20×20 |
Active Repos Glow Brighter
Building labels fade based on how recently a repo was pushed to. Repos updated in the last 3 days have bright, visible labels. As days pass, labels fade out — and repos with no activity in 30+ days have no label at all (hover to reveal). This gives cities a living feel where active projects stand out.
Contributors Become Citizens
The top contributors to each repository appear as pixel-art citizens walking the streets of their kingdom. The #1 contributor to a repo is crowned the King of that building. Their avatar appears as the building's banner.
Claiming Your Repos
Sign In
Click the avatar icon in the header and sign in with your GitHub account.
Auto-Claim
Your public repos with 1+ stars are automatically added as buildings in their kingdoms.
Explore
Navigate the world map, click on kingdoms to enter cities, and find your buildings.
View Stats
Click any building to see repo stats — stars, forks, contributors, and the reigning king.
Navigating the World
Use your mouse or touch to pan around the world map. Each colored region is a language kingdom. Click a kingdom to zoom into its city and see individual buildings. Click a building to view the repository details. Use the back button or click outside to return to the world map.
Enter the Kingdom