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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/haydenschmittyfloorplan.svg)](https://yunodb.com/tools/haydenschmittyfloorplan?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/haydenschmittyfloorplan?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/haydenschmittyfloorplan.svg" alt="Featured on YunoDB" height="20"></a>