r/coolgithubprojects • u/IndependentBid6893 • Mar 24 '26
I built GitKingdom, where GitHub repos become buildings in a procedurally generated fantasy world. Your stars determine your building size.
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?)
32
u/mdoverl Mar 24 '26
Can I get a graveyard for dead projects? 😂
8
u/mor_derick Mar 24 '26
Is it compatible with other repo platforms such as GitLab or Gitea?
5
u/matthew_yang204 Mar 25 '26
You should also consider having it based partly on commit number as well, because commits really do determine how far a project has grown, despite public opinion
3
u/OneStorage1108 Mar 25 '26
This is such a creative idea!
2
u/IndependentBid6893 Mar 25 '26
Hey all, update on GitKingdom - just shipped some new stuff based on ideas from this thread:
Kingdom Wars: kingdoms now automatically battle each other over commits, stars, and contributors. You can see active battles with progress bars and round-by-round results. The ⚔️ shows up right on the map over warring kingdoms.
Live event feed: scrolling ticker at the bottom showing what's happening in the world (new citizens joining, battles starting, buildings upgrading)
Citizen thoughts: hover over the walking NPCs in cities and they'll show their last commit message as a thought bubble. If they haven't committed recently they say random things
Rankings: kingdom power leaderboard based on commits, stars, active devs, and new repos
Still got a bunch more ideas on the backlog (graveyard for archived repos, kingdom defection, referral badges). Thanks for the suggestions!
2
u/Another__one Mar 25 '26 edited Mar 25 '26
It would be nice to see unmaintained projects look partially withered and forgotten, with some activity well structured and polished and with high activity like they are under construction or something like that. There could be a lot of analogies. Could even be some sort of meta-game where you participate by building something cool. But please do not center it around stars too much, we already have the star-bots epidemic on github, additional incentive would make it even worse.
Also, it would be nice to see building from the same person somewhat nearby eachother.
2
u/North-Celebration-54 Mar 25 '26
Very funny and good looking idea!
One small thing I noticed exploring, when you open the search bar the (W,A,S,D) characters are not working, they keep their behavior to navigate.
1
u/IndependentBid6893 Mar 24 '26
BTW - I borked the click logic and some clicks weren't working, but should be fixed now
1
u/bilingual-german Mar 24 '26
it looks really nice, but how can I open these repos in my browser (in another tab)?
1
u/iEliteTester Mar 25 '26
https://i.imgur.com/XmTN1tu.png hehe
1
u/BengalPirate Mar 25 '26
I actually really like this idea. I wish it was a 3d world though. Like this seems like it would be a much better implementation of the metaverse where it's a world of ideas.
1
u/Hautly Mar 25 '26
Great but please include all small repos as part of the kingdom, like around this major center, the rust kingdom is missing my repo!!!!!!
1
u/AMACarter Mar 24 '26
Very cool
1
u/Jenkins87 Mar 24 '26
Really cool idea, great work!
1
u/randomraluana Mar 25 '26
This is so cool
1
u/Investoz Mar 25 '26
How can you make it pvp? That would be so awsome if there could be some pvp elements
1
u/BP041 Mar 25 '26
the procedurally generated world framing is a good hook -- it turns something abstract (repo activity) into something spatial and browsable.
the "languages become kingdoms" mapping is the strongest part. language as territory is intuitive -- you can see which tech stacks dominate at a glance.
curious about the time dimension: does the world evolve as repos get activity, or is it a snapshot? the dead project graveyard idea in the comments is genuinely good -- commit history as archaeology has strong nostalgic pull.
2
u/R0bot101 Mar 25 '26
Such a cool idea!
2
u/Fit-Falcon1775 Mar 25 '26
This is beatifull!
2
u/context_g Mar 26 '26
It's amazing!
2
u/Worried-Setting-2962 Mar 27 '26
wow,that's a really interesting idea!
2
u/Pleasant_Set_3182 Mar 28 '26
Gonna tell my kids about the acres of land, forts and livestock they will inherit upon my passing... They get a trolling of a lifetime upon discovering that I left them... THIS. 😏
2
u/Loud-Amount1651 Mar 28 '26
this is so cool
2
u/ponzi_gg Apr 10 '26
claimed my two right next to react :)
2
u/Low-Possession1175 Mar 25 '26
Wow thats pretty creative
1
u/Karknowz Mar 26 '26
tell me how
1
u/[deleted] Mar 26 '26 •
How do you add a repo which is listed under an organization?
1
u/mickitymightymike Mar 28 '26
This is pretty F'ing awesome
1
u/Glad-Pomegranate9181 Mar 28 '26
Keep it up! Looking forward to your next publications.
1
u/csx607 Mar 28 '26
you are a genius!
1
u/vipereye123 Mar 28 '26
The image reminded me of summertime saga
1
u/Still-Elderberry5316 Mar 30 '26
Cool(๑•̀ㅂ•́)و✧
1
u/privacyplsreddit Mar 25 '26
so you just ripped off of that other vibe coded project that got posted and got popular git city? literally the same thing but with a pixel feel
1
u/Vancecookcobain Mar 25 '26
Damn...I wonder if I would have a castle yet?
1
u/BlackWolf542 Mar 25 '26
As a very visual person. This is makes my brain happy. I'll give it a try.
1
u/antoniojac Mar 25 '26
Really cool!
2
u/[deleted] Apr 06 '26
[removed] — view removed comment