Floorplan

Overview

Floorplan is a Claude Code and Codex plugin that reads a codebase and draws an interactive map. Every part, file and web request gets a plain-English name, and connections between them are shown. The live demo maps Brewline, a sample coffee-shop app, while the plugin is used on your own project.

Key Features

• A zoomable map at every level: start with the whole app, then inspect parts, file groups, files and endpoints, including what each uses and what uses it.
• Plain-English labels and explanations throughout, with a switch to a developer view for technical terms.
• Real connection matching across repos: Floorplan follows imports and matches frontend web requests to the server endpoints that answer them.
• Screen-based exploration: pick a page to see its parts, the requests it makes, the server code, data and outside services behind it.
• Ask the map: questions return an answer plus a mini-map of the involved pieces and a step-by-step walkthrough.
• Health check and recent work: flag common security and configuration issues and highlight what the AI just changed, with notes on why.

Use Cases

• Understand an app you built with AI without reading all the code.
• Onboard teammates from the big picture down to exact files and endpoints.
• See which parts an AI change touched and why after each update.
• Plan an app that has not been built yet from a PRD or spec as a blueprint.

Getting Started

• Install the Claude Code plugin with claude plugin marketplace add haydenschmitty/floorplan and claude plugin install floorplan@floorplan. For Codex, add the marketplace haydenschmitty/floorplan and install floorplan@floorplan, or run codex plugin marketplace add

Deployment & Requirements

• Node.js 18+ and either Claude Code or Codex. Floorplan runs on the plan you already have, with no API keys. The scan, map and small local server run on your computer.

Before You Adopt

• License: MIT. Review its terms before using, modifying, or distributing the project.
• The map and its local server run on the user's computer, and the server only accepts local connections.
• Ask-bar questions depend on the user's Claude Code CLI or Codex account; those tools can read code but not change it.
• Initial map generation can take longer for bigger apps because every file and endpoint is described.
• The Health check is limited to a check rather than a full audit.
• Usage depends on an existing Claude or ChatGPT plan.