Superseded · Original prototype

CodeScape — original prototype

The Create React App build of the 3D codebase city. Same idea as the later version, built on a toolchain that turned out to be the wrong foundation.

Role
Designer & developer
Stack
React · JavaScript · Create React App
Domain
3D codebase visualisation
Status
Superseded by the Vite rebuild
codescape-v1 main window
Main window
1 day to a working prototype
3D codebase as a city
CRA the toolchain that had to go
This is the earlier version

The later CodeScape is a Vite + TypeScript rebuild, available at github.com/JaredCH/codescape2. This repository is the original single-day prototype that proved the concept was worth pursuing.

What it proved

The prototype answered the only question that mattered at the time: does seeing a codebase as a physical space actually help you understand it?

It did. Files became buildings, size became height, and suddenly the shape of a project was legible at a glance — the fat files, the deep directories, the parts that had grown quietly. That's a real thing you can't see in a file tree.

Why it didn't survive

Two problems, and both were about the foundation rather than the idea:

  • The toolchain. Create React App is convenient to start and painful to grow. Once the project needed real performance work, the build setup was fighting the application instead of supporting it.
  • No types. A 3D scene has a lot of interacting data structures — geometries, positions, materials, camera state, per-file metadata. In plain JavaScript, small mismatches surface as silent visual bugs rather than build errors.

What the rebuild changed

The current version is a fresh start on Vite with TypeScript, and more importantly it was designed for performance from the beginning rather than optimised afterwards. Instead of discovering that a few thousand buildings don't render smoothly and then retrofitting fixes, the rebuild ships with:

  • Distance- and count-based level of detail.
  • Frame-rate monitoring with automatic quality downgrading.
  • Reduced per-frame callbacks and frame-skipped animations.
  • Deliberately simple geometry and materials.

The prototype's job was to establish that the idea was worth that investment. It did that in a day, and then it was time to build the real thing.

For the record

This repository is a 66 MB Create React App scaffold with the original scene code in it. It's kept because it's the honest origin of a project I'm glad I pursued, and because deleting your first attempt is a good way to lose track of why you made the second one.

Related projects