What is Floorplan?
Floorplan is a plugin for Claude Code and Codex that reads a codebase and draws an interactive map of it in a local HTML file. Every part, file, endpoint and screen gets a plain-English description, and it matches each web request in a frontend to the server endpoint that answers it, even across separate repositories.
Scripts in plain Node do the mechanical work of parsing imports, routes and requests in a dozen languages; the agent does the naming and describing. On top of the map sit an Ask bar that answers questions with a mini-map of the pieces involved, guided flows, a Recent work board showing what the agent just changed, a Health check for common mistakes in AI-built apps, and blueprints drawn from a PRD before any code exists.
It is MIT-licensed, has no dependencies, and runs on your existing Claude or ChatGPT plan with no API key.
Is Floorplan worth it?
Floorplan is aimed at a reader most code tools ignore: someone who shipped an app with heavy AI help and cannot answer "what happens when someone checks out?". It answers that with a zoomable map written in plain language, and the repository's growth shows the need is real: about 2,568 stars and 187 forks since it was created on 27 October 2026.
The design choice that matters is the split of labour. Parsing, request-to-endpoint matching and layout are deterministic Node scripts with no dependencies; the model only names and describes. That keeps the connections on the map grounded in the code rather than in the model's guesses, and it makes updates cheap, because only changed files are re-read.
The Health check is the feature most likely to earn its place. It flags keys in code or shipped to the browser, Supabase tables anyone can read, open Firebase rules, Stripe webhooks that can be faked and endpoints with no sign-in, each with a fix prompt. The README is honest that it is "a check, not an audit"; it will not find logic flaws, and it covers the mistakes typical of one style of app.
The limits are those of a fast-moving new project. Releases ran from v0.4.4 to v0.6.3 between 31 October and 2 November 2026, there are 8 contributors and 29 open issues and pull requests, and endpoint detection depends on a fixed list of frameworks. A first map of a large app takes longer and draws more on your plan's usage, because every file gets described.
On safety the project does more than most plugins: no hooks, no MCP servers, no downloads, a test that checks this on each change and per-release file fingerprints. Its only outbound call is an opt-in waitlist email. Against Archify, which draws polished diagrams of anything, and Understand Anything, which builds a function-level graph for developers, Floorplan is the one for owners who want to understand and check their own app.
Where it earns its place
A solo founder with a Next.js and Supabase app built mostly by Claude Code
Find out what breaks if the users table changes
Ask for a floorplan, then ask the map; it answers with the pieces involved and a walkthrough. The Health check flags any Supabase tables readable by anyone, with a fix prompt to paste back into Claude Code.
A three-person agency handing a client app to a new developer
Onboard someone in an afternoon instead of a week
Export the floorplan as one HTML file and send it; the developer view switch shows technical names. Updates re-read only changed files, so keeping it current costs little of the plan.
A product manager with a PRD and no code yet
See every part, endpoint and screen the feature will need
Share the PRD and ask for a floorplan; the blueprint marks planned parts with dashed cards and lists open decisions. When the code exists, the same map becomes a map of the real thing.
Before you commit
- Setup
- Node.js 18 or later; in Claude Code run claude plugin marketplace add haydenschmitty/floorplan then claude plugin install floorplan@floorplan, or add the marketplace in the Codex app. Ask for a floorplan; a small app maps in a few minutes.
- Integrations
- Claude Code and Codex. Parses TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin and Scala; endpoints for Express, Fastify, Next.js, FastAPI, Django, Gin, Axum, Spring and others; screens for Next.js, React Router, Vue, SvelteKit and more.
- Data and privacy
- The scan, map and local server run on your machine and accept local connections only; the AI reads files through your own account as usual. No analytics; the only outbound request is an opt-in waitlist email. Writes a git-ignored floorplan/ folder.
- Cost at scale
- No fee; each first map and update draws on your Claude or ChatGPT plan. Large projects are split across parallel helpers, so they use more of the plan.
- Limits
- 29 open issues and pull requests; frameworks outside the list get lighter support; the Ask bar needs the Claude Code CLI or Codex to read real code.
What’s good
- Plain-English map that links frontend requests to backend endpoints across repos
- Health check for leaked keys, open Supabase and Firebase rules and fakeable webhooks
- Recent work view shows what the agent just changed and why
- No dependencies, no hooks, local-only server, MIT licence
- Runs on an existing Claude or ChatGPT plan
What’s not
- Created on 27 October 2026, with one main author
- Health check covers common patterns only, not a security audit
- First maps of large codebases are slow and use plan quota
- Endpoint and screen detection limited to listed frameworks
Best for
Founders and small teams who built an app with Claude Code or Codex and need to understand, explain or sanity-check it without reading every file.
Floorplan alternatives
Floorplan: common questions
- Is Floorplan worth it?
- A genuinely useful map for people who built an app with AI and cannot read it, though at one week old it is still a young plugin from one author. We rate it 4.0 out of 5.
- How much does Floorplan cost?
- Free under the MIT licence. Map generation uses your own Claude or ChatGPT plan; no separate API key or fee.
- What are the downsides of Floorplan?
- Created on 27 October 2026, with one main author; health check covers common patterns only, not a security audit; first maps of large codebases are slow and use plan quota; endpoint and screen detection limited to listed frameworks.
- Who is Floorplan best for?
- Founders and small teams who built an app with Claude Code or Codex and need to understand, explain or sanity-check it without reading every file.
- How much does Floorplan cost for a team or in production?
- No fee; each first map and update draws on your Claude or ChatGPT plan. Large projects are split across parallel helpers, so they use more of the plan.
- Is Floorplan safe for company data?
- The scan, map and local server run on your machine and accept local connections only; the AI reads files through your own account as usual. No analytics; the only outbound request is an opt-in waitlist email. Writes a git-ignored floorplan/ folder.
- What are the best Floorplan alternatives?
- The closest alternatives we have reviewed are Archify and Repomix.
Answers checked Nov 3, 2026.
Make Floorplan? Show this rating on your site
