ArchMap
Architecture survey
Runs entirely in your browser
001

See any codebase
as a map, not a maze.

You own code you didn't fully write: an app built with AI, a repository you inherited. Hand it over. Thirty seconds later you're reading its real architecture: what starts it, what talks to what, where the data lives, what's dead. Every wire is an import that exists in the code, citable to its exact line.

✓ Nothing you load leaves this browser. There is no server to upload to.

A
GitHub repository
B
Local folder

or drag it onto this row. Files are read here, uploaded nowhere.

C
archmap.json

from an export, or the Claude Code skill

D
Live website surface only

pages & scripts only; real architecture needs source

First time? Try expressjs/express or pallets/flask. Private repos work with a token in Settings.

002

Read it — what the analyzer computed, nothing invented

Your files arrive already sorted into layers, left to right: the front door, the routes, the working core, where data lives, the outside world. Then the map starts explaining itself.

2.1
The tour

Short chapters walk you through your own system in plain language: where execution starts, the spine most requests travel, the files everything leans on, what's dead.

2.2
Evidence

Click any wire and it shows you the exact import that created it, file and line, with a link straight to the source. A claim you can check is the only kind here.

2.3
Findings

Dead code, circular imports, hot files, layering violations: surfaced automatically, each one verifiable on the canvas.

2.4
Everything

Big repo? Low-traffic files wait in a searchable overflow: listed, expandable, never hidden. The whole codebase is reachable.

003

Ask it — answers are computed from the graph, never generated

Type a question in the map's top bar. A query engine parses it and answers by computation, so the answer cannot be made up. When there's nothing to find, it says so.

You

who imports analyze.js

Map

6 files feed analyze.js · 7 imports · 1 hop. Highlighted on the canvas, each one clickable.

You

circular imports

Map

0. None. That's good. Nothing was invented to fill the gap.

You

path from main.js to render.js

Map

Route main.js → render.js · 1 hop. The journey, step by step, every step a real import.

These are real answers from the specimen above. Reach, routes, dead code, biggest files, "explain X". With an API key, any phrasing gets translated into a query. Translated: the answer is still computed.
004

Change it — every map is editable; new systems start from a sentence

Drag components, draw wires, edit anything, undo freely. Or describe a product you haven't built: answer a few sharp questions, and get a complete proposed architecture with every assumption stated. Then tell it what to change, in your own words.

Works without any API key. You get a vetted starter blueprint, honestly labeled.

A

Annex A — Controls

Hover · click · double-clickspotlight a file's wires · pin it and read details · zoom to it
g tourguided chapters; [ ] to move between them
u / d reacheverything that feeds the selected file / everything it reaches, with a receipt: files · imports · hops
r routethe shortest real import chain between two files
/ ask"who imports app.js" · "dead code" · "biggest files", or just search a file name
click a wirethe exact file:line import that created it
p traceone animated pass along the critical path
Editdrag, add, connect, delete, with undo (⌘Z), on any map
?the full manual, on the map itself
B

Annex B — Optional AI, your own key

EnrichClaude reads your most important files and writes plain-language descriptions, a system overview, and maintainer findings.
Find bugsReports only problems it can actually see, each cited to file and line. Nothing is uploaded anywhere else.
Design & editGenerates architectures from your idea and turns instructions into checked changes. Validation gates everything.
Private by designYour key lives in this browser only; calls go straight to api.anthropic.com. No key? Everything else still works.