Floorplan: Mapa interativo de código para entender apps construídos com IA

---

Dados rápidos

• Repositório: haydenschmitty/floorplan
• Licença: MIT
• Linguagem: JavaScript
• Estrelas: 1.964 (1.140 no período recente)
• Forks: 143
• Ranking: Trendshift (mensal: #12 em JavaScript)
• Última consulta: 2026-11-02

---

O que resolve e como funciona

O Floorplan resolve um problema comum em equipes que usam IA para desenvolvimento: quando um aplicativo é construído por meio de prompts ou plugins de IA, fica difícil entender sua estrutura real. Muitas vezes, mesmo os desenvolvedores não sabem quais partes do sistema interagem entre si, quais endpoints são mais críticos ou quais dependências externas (como APIs de pagamento) estão expostas. Isso gera incertezas em manutenção, onboarding e até mesmo em decisões de segurança.

O projeto funciona por meio de um plugin integrado a modelos de linguagem como Claude Code ou Codex. Ao analisar um repositório ou projeto, ele gera um mapa interativo onde cada arquivo, função ou endpoint recebe uma descrição em linguagem natural (exemplo: "processa dados de cadastro" ao invés de "handleUserData"). As conexões entre componentes são mostradas de forma visual, permitindo navegar por como o sistema funciona em diferentes níveis de detalhe — desde a visão geral até a análise de um único arquivo.

Para instalar, basta executar:

npm install -g floorplan

O comando inicializa o plugin e permite gerar o mapa diretamente do terminal ou via interface web.

---

Casos de uso práticos

1. Onboarding de novos desenvolvedores: Em uma equipe que usa IA para desenvolvimento, o mapa ajuda a explicar a arquitetura do sistema em minutos, evitando que o novo membro passe horas lendo código. Por exemplo, ao clicar em um endpoint de checkout, ele verá não só o que ele faz, mas também quais outras partes do sistema dependem dele.

1. Verificação de segurança: Identificar endpoints vulneráveis ou APIs externas mal configuradas é mais fácil com um mapa visual. O Floorplan destaca, por exemplo, "keys em código" ou "tabelas do Supabase abertas sem restrições", alertando sobre possíveis brechas.

1. Trabalho com IA: Depois que um modelo de linguagem (como Claude) faz alterações no código, o mapa mostra exatamente quais partes foram modificadas e por que. Isso ajuda a evitar conflitos ou erros inesperados.

1. Documentação rápida: Equipes que precisam explicar um sistema a clientes ou stakeholders podem usar o mapa para criar uma visão clara, sem precisar criar diagramas manuais.

1. Análise de impacto de mudanças: Ao editar um arquivo ou fazer um PR, o usuário pode ver instantaneamente como essa alteração afeta o resto do sistema, facilitando decisões de revisão.

---

Como se diferencia dos concorrentes

O Floorplan não é o único projeto que transforma código em diagramas, mas destaca-se em alguns aspectos:

• Foco em IA e desenvolvimento colaborativo: Enquanto ferramentas como Archify ou Understand Anything são mais voltadas para documentação ou análise profunda de código, o Floorplan é ideal para equipes que usam IA diariamente. Ele integra-se diretamente com plugins de IA (Claude Code, Codex) e mostra recentemente alterações feitas por esses modelos.

• Visualização dinâmica: Ao contrário de ferramentas estáticas, o mapa é interativo: o usuário pode clicar em qualquer parte e ver como ela interage com o resto do sistema, em diferentes níveis de detalhe.

• Avaliação de riscos: O projeto inclui funcionalidades como "health check" para identificar endpoints expostos ou dependências críticas, algo comum em sistemas complexos.

Alternativas como Archify ou Understand Anything são mais voltadas para documentação técnica ou análise detalhada de código, enquanto o Floorplan é mais prático para equipes que precisam entender rapidamente como um sistema funciona sem entrar em detalhes técnicos.

---

Limitações e cuidados

Embora promissor, o Floorplan ainda enfrenta desafios:

• Dependência de modelos de linguagem: O mapa é gerado a partir de respostas de Claude ou Codex, o que pode introduzir erros ou interpretações incorretas, especialmente em sistemas muito complexos ou com código pouco documentado.

• Maturidade recente: Criado em outubro de 2026, o projeto ainda não tem uma versão estável para uso em produção. A última atualização foi em 2 de novembro, e há 41 issues abertas, indicando possíveis bugs ou melhorias pendentes.

• Licença MIT: Embora permissiva, a licença não restringe o uso comercial, mas não garante suporte oficial para empresas.

• Dados ausentes: Não há informações no repositório sobre performance (tempo de geração do mapa) ou suporte a repositórios grandes (mais de 100MB). O uso em sistemas muito complexos pode demandar mais recursos.

• Segurança: Como o projeto usa APIs externas (Claude/Codex), é importante verificar se há riscos de exposição de dados sensíveis durante a geração do mapa.

---

Resumo rápido

• Projeto: Floorplan é um mapa interativo de código gerado por IA, que visualiza arquitetura, dependências e interações em aplicativos construídos com ajuda de modelos como Claude e Codex.
• Licença: MIT (permissiva e livre para uso comercial).
• Linguagem: JavaScript.
• Estrelas: 1.964 (1.140 no período recente).
• Ranking: Trendshift (mensal: #12 em JavaScript).
• Risco principal: Dependência de modelos de linguagem externos, possíveis erros na interpretação do código e maturidade ainda recente.

---

Fontes

• Repositório: haydenschmitty/floorplan
• Última release: floorplan--v0.6.1
• Homepage: haydenschmitty.github.io/floorplan-demo/
• Trendshift: Trendshift.io