New here? Take the tour to see what this code does, step by step, in plain English.
harbor (example repo)Sample
files
0
lines
0
commits
0
fires
0
Repository
Understand a codebase at a glance: where it starts, what it depends on, how its workflows run, and how it grew. Each file is a building, each folder a district.
How much history?
Drag both ends to pick a stretch of history
How GitHub's request limit works
Start here, then take the tour.
Color buildings by
Over time
Colours
What this is
Code City™ shows a code project as a city, so you can see its shape at a glance.
Reading the city
Each building is a file. Taller means more functions; wider means more lines of code.
Each district is a folder.
Fire on a roof means a TODO note in the code.
Lines between buildings show which file uses which.
Lit buildings are the ones the open panel is about. The rest dim.
Good to know
Ask, tours and explanations are written by AI, so check them against the code. Signing in to GitHub turns them on and lets you load more.
Moving around
Drag to turn the city, scroll to zoom, right-drag to move. Esc closes what's open.
The code behind it
Code City is on GitHub, where you can read its code, report a problem or follow new versions. View on GitHub
Who is it for?
A quick look around, one part at a time.
Start here
Repo: paste a GitHub link, or open a folder.
Understand: see where the code starts and how it flows.
Understand: take a tour of what the code does and where it starts.
Click a building to see what that file does.
Ask at the top: ask a question about the code.
Moving around
Drag to turn, scroll to zoom, right-drag to move.
Esc closes what's open.
Signing in raises GitHub's limit from 60 to 5,000 requests an hour, and unlocks Ask, tours and explanations.
Signed in as GitHub
Get more GitHub requests: add a token
Raises GitHub's limit from 60 to 5,000 requests an hour, and opens private repos. Create a fine-grained token: Public repositories for more requests, or, for private ones, Only select repositories with Contents: Read-only. It can't change anything, and it is only ever sent to api.github.com. A private repo's files cost one request each.