// the find
srizzon/git-city
Your GitHub profile as a 3D pixel art building in an interactive city
Git City renders every GitHub profile as a pixel art building in a shared 3D city — contribution count drives height, repo count drives width, stars drive window brightness. It's a social visualization toy built on Next.js + react-three-fiber with real-time multiplayer via PartyKit. The audience is developers who want a fun profile flex, not developers who want to run infrastructure.
- The 3D renderer uses instanced meshes with a LOD system — close buildings get full animated geometry, distant ones get simplified meshes. That's the right call for a scene that can have thousands of buildings and it's implemented properly, not bolted on.
- Local dev setup is genuinely usable: local Supabase via CLI, a dev login endpoint that bypasses GitHub OAuth, and seed-from-scratch migrations. You can run the whole stack without any external accounts.
- The VS Code extension tracks coding activity and feeds it back to the building, which is a clever engagement loop — your building visibly changes as you work.
- PartyKit integration handles real-time presence and the multiplayer arcade mode as a separate layer, so the main Next.js app doesn't have to manage WebSocket state directly.
- AGPL-3.0 means any public deployment must open-source your modifications. Fine for contributors, a hard stop for anyone who wants to fork this for a private team or company without publishing their changes.
- The shared city is the product — if you self-host, you get an empty city with one building. The whole appeal is the social density of thegitcity.com, which you can't replicate by running your own instance.
- The codebase has expanded well past the core concept: ads dashboard, job board, landmark management, email monitoring, PIX payment flows, arcade rooms. The directory tree reads like a startup's production monorepo, not a focused open-source project — contributions are harder, and the README still has commented-out screenshot TODOs.
- No tests anywhere in the tree. A 3D rendering project with instanced geometry, LOD thresholds, and building dimension calculations is exactly the kind of code that benefits from unit tests on the math — none exist.