Understand any TypeScript repo in one interactive map.
- Year
- 2026
- Role
- Author
- Stack
- TypeScript, Compiler API, SVG, Node.js
Overview
Parses every import with the TypeScript compiler API and turns a project into a standalone architecture map – every connection links to the line that proves it.
Architecture diagrams drift from the code the day they are drawn. RepoAtlas derives the map from the code itself: the TypeScript compiler API resolves every import, and every edge on the map links to the exact statement and line behind it.
A Focus map shows a module's direct neighbours, an Impact map everything that transitively depends on it, and circular import groups are isolated edge by edge. The output is one HTML file you can share.
- 247
- modules in the Hono map
- 676
- connections traced
- 1
- HTML file to share
Implementation
01
The compiler as the source of truth
Imports are resolved with the same module resolution TypeScript uses, including path aliases and re-exports – no regex guessing.
02
Evidence on every edge
Each connection stores file, line and the import text, so any claim on the map can be verified with one click.
Technical challenges
Readable at 600+ edges
Layered layout by dependency depth, focus and impact views, and cycle groups pulled out so large graphs stay legible.
Architecture
Resolve → build graph → detect cycles (Tarjan) → lay out → render into a single self-contained HTML file.
npx --yes --package=github:maximilianfeix/repoatlas -- \
repoatlas https://github.com/pmndrs/zustand -o zustand-map.html