PluginPartly tested (needs an account)
Map your app in plain English
Floorplan
A free MIT plugin that draws an interactive map of your app, names every part in plain English and flags risks such as passwords left in the code.
- Works with
- Claude Code, Codex CLI
- Good for
- Build an app
What it does
If you built an app with lots of help from AI, you may not know how its pieces fit together. Floorplan asks your assistant to read the project and draw a map you can click through in your browser.
Each part, file and web request gets a plain-English label, such as "takes card payments at checkout". You can zoom from the whole app down to one file, start from a screen you know, or type a question into the map ("what breaks if I change the users table?").
A health check points out keys left in the code, database tables anyone can read, endpoints anyone can call without signing in, unused files and files too big to edit safely. Each comes with a fix you can paste back to your assistant. It can also draw a "blueprint" from a plan document before any code exists.
Version 0.7.1 (10 November 2026) makes maps safer to share: text that looks like a key or password shows as «hidden», and an exported copy cannot contact anything. The map also works in a private window. Version 0.7.0 (9 November 2026) adds a mode for scripts and CI (FLOORPLAN_UNATTENDED=1); nothing changes when you use Floorplan in Claude Code or Codex.
Example prompts
- "Make me a floorplan of this app."
- "Update the floorplan."
- "Fix the important issues from the floorplan's Health check."
- "Here's my PRD. Make me a floorplan of what we'd need to build."
How to install
claude plugin marketplace add haydenschmitty/floorplanclaude plugin install floorplan@floorplanHow to use it
Open your project, start a new session and ask: Make me a floorplan of this app. Later, ask: Update the floorplan.
Check it works
Start a new Claude Code session in your project and ask "Make me a floorplan of this app". After a few minutes a map opens in your browser at a http://127.0.0.1 address, starting with a short tour, and a floorplan/ folder appears in the project.
Common problems
- Nothing happens after install — start a new session so the plugin loads — https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md
- The map's Ask bar cannot answer from the desktop app — install the Claude Code CLI too, as the README recommends — https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md
- Frontend and backend in separate repos are not linked — open the folder that holds both before asking — https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md
- The scripts fail to start — check that Node.js 18 or newer is installed with
node --version— https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md
Other assistants
- Codex:
codex plugin marketplace add haydenschmitty/floorplanthencodex plugin add floorplan@floorplan; ask for a floorplan or type$floorplan. The Codex app can also add the marketplace from its Plugins screen — https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md - Gemini CLI: not supported (the README lists Claude Code and Codex only).
What to watch out for
- The skill pre-approves its own scripts: SKILL.md allowed-tools lets the assistant run eight Node scripts in the plugin (scan, build, describe, open and others) without asking you, and a line at the top of SKILL.md runs status.mjs each time the skill is invoked. The scripts read your project, run git and write only the floorplan/ folder. In blueprint mode SKILL.md also tells the assistant to save a PRD pasted in chat as docs/prd.md (commit 70be3f4)
- Opening the map starts a small local web server (floorplan/serve.mjs) on 127.0.0.1 only, with a random access token. It keeps running for up to 120 minutes after the last map tab closes; stop it with node floorplan/serve.mjs --stop
- The map's Ask bar runs your own assistant on your account: claude -p with read-only tools (Read, Grep, Glob, and Bash limited to floorplan/query.mjs), or codex exec in its read-only sandbox. Each question uses your plan's usage
- Two minutes after a map opens, a card asks if you want to join the Floorplan Cloud waitlist. Only if you click Notify me does the local server send the email in the box and 'solo' or 'team' to a Google Cloud Run service run by the author. The 'Use my Claude email' button runs claude auth status to fill the box. Your answer is stored in ~/.floorplan/settings.json; FLOORPLAN_NO_PROMPTS=1 turns the card off. This is the only outside request in the code
- In Claude Code it adds a short section to CLAUDE.local.md only if you say yes, and then adds that file to .git/info/exclude. No hooks, no MCP servers and no package dependencies (checked in the code at 70be3f4); needs Node.js 18 or newer
- Very new: the repo and the author's GitHub account were both created on 2026-10-27, and 24 version tags came out by 2026-11-10 (0.7.1; GitHub release pages stop at 0.6.3, later notes are only in CHANGELOG.md). The plugin installs from the main branch, so what you get can change daily
- Before 0.7.1 (10 November 2026) a map could show a key or password that was written into a description, label or note, and an odd string in a file name or endpoint could blank the whole map. Since 0.7.1 such values show as «hidden», maps carry a Content-Security-Policy so an exported copy cannot contact anything, and invisible or text-reversing characters in names show as markers such as [U+202E]. Update and rebuild the map before you share an exported copy (CHANGELOG 0.7.1)
Licence and author
- Licence
- MIT
- Author
- Hayden Smith
- Source code
- github.com/haydenschmitty/floorplan
How we tested it
We installed it on an empty test computer on 3 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 3 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 10 Nov 2026
Alternatives
- Archify — turns ideas and code into diagrams, without the health check
- Feature Dev plugin (Anthropic) — explores code to build a feature, not to draw a map
- Planning with Files — tracks the plan for a task, not the structure of the app
FAQ
- Q: Does my code leave my computer? A: Only the way your assistant always works: it reads files through your own account. The map is a local file and its server listens only on your computer. In the Claude desktop app, the skill can offer to publish the map (paths, names, descriptions and structure, not your source code) to your private claude.ai account; it must ask you first — https://github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/skills/floorplan/SKILL.md
- Q: Will it change my code? A: No. It writes its own
floorplan/folder, which git ignores; a blueprint may also save your PRD asdocs/prd.md. Fixes happen only if you ask your assistant to make them. - Q: Does it cost money? A: The plugin is free (MIT). It runs on your existing Claude or ChatGPT plan, with no API key.
Sources
- github.com/haydenschmitty/floorplan
- github.com/haydenschmitty/floorplan/tree/70be3f40f9c2e061290b76027f180d9ff892edd6
- github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/README.md
- github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/skills/floorplan/SKILL.md
- github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/skills/floorplan/assets/serve.mjs
- github.com/haydenschmitty/floorplan/blob/70be3f40f9c2e061290b76027f180d9ff892edd6/docs/privacy-and-security.md
- github.com/haydenschmitty/floorplan/releases/tag/floorplan--v0.6.3
- github.com/haydenschmitty/floorplan/blob/42b94d7/CHANGELOG.md