Repo of the Day
haydenschmitty/floorplan: See how your app actually fits together. An interactive, plain-English map of your codebase, drawn by Claude or Codex.
Published: Nov 2, 2026
Open repository ↗See how your app actually fits together. An interactive, plain-English map of your codebase, drawn by Claude or Codex. - haydenschmitty/floorplan
Summary
Floorplan is a Claude Code and Codex plugin that scans a codebase and creates an interactive, plain-English map of its parts, files, screens, web requests, endpoints, and external services. It can also turn a PRD into a planned blueprint, trace application flows, highlight recent AI-assisted changes, and identify several common security issues.
What it is useful for
Floorplan is useful when engineers need a system overview without manually tracing every dependency. For example, a team can start from a checkout screen and follow the request to the server endpoint, database, and payment service. It follows imports and matches frontend requests to backend endpoints, including across separate repositories.
The generated map supports several practical questions, such as:
- “What happens when someone places an order?”
- “How does a refund reach the customer’s card?”
- “If I change the users table, what breaks?”
- “Which files handle login?”
The Health check looks for issues including exposed keys, browser-exposed secrets, permissive Supabase tables, open Firebase rules, fakeable Stripe webhooks, and endpoints without sign-in. Findings include suggested fixes, but the README explicitly describes this as a check rather than a full security audit.
“Recent work” highlights files changed by AI and explains how those changes relate to the request. Blueprints provide the same map format for an application described in a PRD, with dashed cards distinguishing planned components from existing code.
Documented language coverage includes TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, and Scala, plus Vue, Svelte, and Astro files; other languages receive lighter support. Endpoint and screen recognition is also limited to the frameworks listed in the README. A first map takes a few minutes for a small application and longer for a large one.
How engineers can use it
Install Node.js 18+ and Claude Code or Codex. For Claude Code:
claude plugin marketplace add haydenschmitty/floorplan
claude plugin install floorplan@floorplan
For Codex:
codex plugin marketplace add haydenschmitty/floorplan
codex plugin add floorplan@floorplan
Open the project in Claude Code or Codex and ask:
Make me a floorplan of this app.
For separate frontend and backend repositories, open the folder containing both. After further changes, ask:
Update the floorplan.
Only changed files are re-read, and recent changes appear under “Recent work.” The map opens locally in a browser and can be exported as one HTML file. Floorplan creates a floorplan/ directory; in Claude Code it may also add a section to CLAUDE.local.md with your approval. These are not committed, and the plugin does not modify application code or tracked .gitignore files.