haydenschmitty/floorplan

What it solves

Floorplan solves the problem of not knowing how your codebase is structured, especially when it has grown large or was built with AI assistance. It provides a visual map that explains what your code does in plain English, helping you understand how different parts of your application connect, what happens during specific user actions, and where potential issues like security vulnerabilities or unused files exist.

How it works

Floorplan uses Claude Code or Codex to scan your codebase, including files, imports, and web requests. It identifies the purpose of each component and generates an interactive, local-only map. You can interact with this map by asking questions in plain language, such as "What happens when someone places an order?" or "Where do we talk to Stripe?" The tool updates incrementally as you make changes to your code, ensuring the map stays current without requiring manual maintenance.

Who it’s for

It is designed for individual developers and teams who need to quickly understand complex codebases, onboard new team members, or track how AI-driven changes affect their application's architecture. It is also useful for planning new projects by generating blueprints from product requirements.

Highlights

• Interactive, zoomable maps that show connections across files and repositories.
• Plain-English descriptions for code components and technical endpoints.
• "Ask the map" feature for tracing data flows and answering architectural questions.
• Automated health checks to identify security risks, unused files, and oversized components.
• "Recent work" view that highlights changes made by AI assistants.
• Blueprint mode for visualizing and planning applications before writing code.
• Runs locally on your machine with no external dependencies or code commitment to git.