srizzon /git-city

Your GitHub profile as a 3D pixel art building in an interactive city

★ 5,995⑂ 295👁 20⑃ 120● 35▤ 0
TypeScriptAGPL-3.0Created 2026-02-20thegitcity.com
+1
日增长
5,995
stars
295
forks
20
watchers
120
prs
35
issues
0
releases

README

Git City


  Your GitHub profile as a 3D pixel art building in an interactive city.



  thegitcity.com



  


---

 What is Git City?

Git City transforms every GitHub profile into a unique pixel art building. The more you contribute, the taller your building grows. Explore an interactive 3D city, fly between buildings, and discover developers from around the world.

 Features

- 3D Pixel Art Buildings — Each GitHub user becomes a building with height based on contributions, width based on repos, and lit windows representing activity
- Free Flight Mode — Fly through the city with smooth camera controls, visit any building, and explore the skyline
- Profile Pages — Dedicated pages for each developer with stats, achievements, and top repositories
- Achievement System — Unlock achievements based on contributions, stars, repos, referrals, and more
- Building Customization — Claim your building and customize it with items from the shop (crowns, auras, roof effects, face decorations)
- Social Features — Send kudos, gift items to other developers, refer friends, and see a live activity feed
- Compare Mode — Put two developers side by side and compare their buildings and stats
- Share Cards — Download shareable image cards of your profile in landscape or stories format






 How Buildings Work

| Metric         | Affects           | Example                                |
|----------------|-------------------|----------------------------------------|
| Contributions  | Building height   | 1,000 commits → taller building        |
| Public repos   | Building width    | More repos → wider base                |
| Stars          | Window brightness | More stars → more lit windows           |
| Activity       | Window pattern    | Recent activity → distinct glow pattern |

Buildings are rendered with instanced meshes and a LOD (Level of Detail) system for performance. Close buildings show full detail with animated windows; distant buildings use simplified geometry.

 Tech Stack

- Framework: Next.js 16 (App Router, Turbopack)
- 3D Engine: Three.js via @react-three/fiber + drei
- Database & Auth: Supabase (PostgreSQL, GitHub OAuth, Row Level Security)
- Styling: Tailwind CSS v4 with pixel font (Silkscreen)
- Hosting: Vercel

 Getting Started

bash
 Clone the repo
git clone https://github.com/srizzon/git-city.git
cd git-city

 Install dependencies
npm install

 Set up environment variables

 Linux / macOS
cp .env.example .env.local

 Windows (Command Prompt)
copy .env.example .env.local

 Windows (PowerShell)
Copy-Item .env.example .env.local

 Fill in your environment variables

 Run the dev server
npm run dev


Open http://localhost:3001 to see the city.

 Local Supabase (no remote project needed)

You can run the whole backend locally — no Supabase account, no GitHub OAuth app.

Prerequisites: a container runtime and the Supabase CLI.

bash
 macOS (Colima is a lightweight, free Docker alternative)
brew install colima docker supabase/tap/supabase
colima st

Top issues

Discussions

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON