DEV Community

Cover image for I built GitKingdom, where GitHub becomes a fantasy kingdom
Robert Gourley
Robert Gourley

Posted on

I built GitKingdom, where GitHub becomes a fantasy kingdom

https://www.gitkingdom.com

It takes GitHub data and transforms it into an explorable pixel-art RPG world, languages become kingdoms, repositories become buildings, and contributors become citizens with RPG stats.

How it works:

  • Each programming language gets its own kingdom territory on the world map
  • Repos become buildings — more stars = bigger building (hovels → cottages → castles → citadels)
  • Contributors become citizens with RPG titles based on their commit rank
  • Top contributor to each repo is crowned King
  • Sign in with GitHub to claim your repos and see your kingdom
  • Anyone can add any public repo with 1+ stars

Try it now:

  • Sign in with GitHub to claim your repos and find your buildings on the map

Current state:

  • 13 kingdoms (TypeScript, Python, Rust, Go, Java, etc.)
  • Thousands of repos already mapped
  • Citizen profile pages with RPG stats and badges
  • Explorable Phaser 3 game with zoom, pan, cities

Tech stack (for the curious):

  • Phaser 3 game engine + TypeScript
  • Procedural world generation (landmass, elevation, biomes)
  • Vercel serverless + Supabase Postgres
    • GitHub API with multi-token pooling
  • Pre-baked world JSON + delta sync for fast loads

Looking for:

  • Repos to add - the more repos, the bigger the world gets
    • Feedback
    • Bug reports
    • Game artists
    • Ideas for new features (quests? building interiors? battles between kingdoms?)

https://www.gitkingdom.com

Top comments (0)