floorplan
See how your app actually fits together. An interactive, plain-English map of your codebase, drawn by Claude or Codex.
What is floorplan?
See how your app actually fits together. An interactive, plain-English map of your codebase, drawn by Claude or Codex.
Overview of floorplan
What it is
Floorplan is an interactive, plain-English map of your codebase, drawn by Claude or Codex. It reads your code and shows every part, file, and web request with a human-readable name, along with all connections between them. It runs on your machine and does not commit anything to git.
Key features
- A map at every zoom: start with the whole app, then double-click into a part, a group of files, a file, and its endpoints. Each view shows what it is used by and what it uses.
- Plain English everywhere: technical terms are explained on hover, and one switch shows the developer view.
- Real connections, across repos: it follows imports and matches each web request in your frontend to the server endpoint that answers it, even across separate repositories.
- Start from a screen: pick a page you know and see everything behind it—its parts, the requests it makes, the server code, the data, and outside services.
- Ask the map: questions like “How does a refund reach the customer's card?” return an answer plus a mini-map of just the pieces involved, with a step-by-step walkthrough.
- Health check: catches common mistakes in AI-built apps—keys in code, open Supabase tables, open Firebase rules, fakeable Stripe webhooks, and endpoints with no sign-in—each with a ready-to-paste fix.
- Recent work: cards your AI just changed light up green, each with a note on how the change serves what you asked for.
Use cases
- For builders: understand the app you made, in your own words, without reading the code.
- For teams: onboard someone in minutes, from the big picture down to the exact file.
- For working with AI: after every change Claude or Codex makes, see exactly which parts it touched and why.
Getting started
You need Node.js 18+ and either Claude Code or Codex. Floorplan runs on the plan you already have, with no API keys.For Claude Code:bashclaude plugin marketplace add haydenschmitty/floorplanclaude plugin install floorplan@floorplanFor Codex:1. In the Codex app, open Plugins and choose Add a marketplace.2. For Source, enter haydenschmitty/floorplan and click Add marketplace.3. Find Floorplan and click + to install it.Or, from a terminal:bashcodex plugin marketplace add haydenschmitty/floorplancodex plugin add floorplan@floorplanQuick start:1. Open your project in Claude Code or Codex. For a frontend and backend in separate repos, open the folder that holds both.2. Ask: “Make me a floorplan of this app.” (In Codex you can also type $floorplan.)3. Explore. The map opens on its own, starting with a short tour.
License and pricing
License: MIT. Pricing type: open source.
Based on the project's public README and repository metadata.