Code City

Code City

harbor (example repo)Sample
files
0
lines
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.

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

  1. Repo: paste a GitHub link, or open a folder.
  2. Understand: see where the code starts and how it flows.
  3. Understand: take a tour of what the code does and where it starts.
  4. Click a building to see what that file does.
  5. 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.
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.