git404hub

what is codecity fr?

firaslatrech/codecity — explained in plain English

Analysis updated 2026-05-18

6JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

tl;dr

A tool that turns any public GitHub repository into a drivable 3D city, where files become buildings and folders become districts.

vibe map

mindmap
  root((CodeCity))
    What it does
      Repo becomes a city
      Files become buildings
      Folders become districts
    Tech stack
      JavaScript
      three.js
      Vite
      Node.js
    Use cases
      Visualize codebase structure
      Commit history timelapse
      Share city snapshots
    Audience
      Vibe coders
      Developers
      Repo visitors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Visualize a codebase's structure as a drivable 3D city

VIBE 2

Spot the most frequently changed files by their glowing windows

VIBE 3

Watch a repository's commit history play out as the city being built

VIBE 4

Generate a shareable image or video clip of a repository's city

what's the stack?

JavaScriptthree.jsViteNode.js

how it stacks up fr

firaslatrech/codecityanil-matcha/open-ai-vibe-coding-coursearthurmoorgan/drift
Stars666
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-30
MaintenanceActive
Setup difficultyeasyeasymoderate
Complexity2/51/52/5
Audiencevibe coderpm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

AI-generated landmarks are optional and require a free Groq API key, everything else works without any key.

in plain english

CodeCity takes any public GitHub repository and turns it into a small 3D city you can actually drive around in your browser. Each file in the repo becomes a building, with its height based on how many lines of code it has and its footprint based on its size, and each folder becomes a district, so the overall shape of the repository turns into a street layout you can navigate like a town. Files that get changed the most often show up as buildings with glowing windows, and the repository's top contributors appear as faces near the entrance, using their real GitHub avatars. You get to pick from three drivable cars, each with its own handling and an engine sound built entirely from synthesized audio rather than sound files. Pressing different keys unlocks extra modes: watching the city rebuild itself commit by commit over time, racing through a set of checkpoint gates, collecting coins scattered through the streets, or saving a short video clip and image of your city to share. You can also drive up to any building and press a key to open and read that actual file from the repository. If you provide a free Groq API key, an AI model will look at the repository's statistics and pick a handful of landmark buildings to highlight along with a short city motto, though this step is entirely optional and the city works fine without it. Running it yourself only requires cloning the project, installing dependencies with npm, and starting the development server, after which you paste in any public GitHub repository URL and the tool fetches just enough of the repository, not a full copy, to build the city. The whole renderer depends on only two external libraries, three.js for the 3D graphics and Vite for running the development server, while a separate small script does all the analysis of the repository itself using only Node's built in tools. Very large repositories are handled by capping how many files and how much commit history get processed, so things stay fast even on big codebases. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me run CodeCity locally and turn my own GitHub repo into a city
prompt 2
Explain how CodeCity decides a building's height and footprint from a file
prompt 3
Set up a free Groq API key so CodeCity can generate AI landmarks for my repo
prompt 4
How does CodeCity keep large repositories fast to analyze and render?

Frequently asked questions

what is codecity fr?

A tool that turns any public GitHub repository into a drivable 3D city, where files become buildings and folders become districts.

What language is codecity written in?

Mainly JavaScript. The stack also includes JavaScript, three.js, Vite.

How hard is codecity to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codecity for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.