Repolode
millionco

millionco/react-doctor

Uma CLI e skill de agente que analisa codebases React em busca de problemas de estado, performance, segurança, acessibilidade e manutenção.

Estrelas
15,016
Forks
490
Issues abertas
314
Último commit
há 13 horas

O que é?

O React Doctor é uma ferramenta de linha de comando que executa verificações determinísticas em código React e aponta problemas de estado e efeitos, performance, arquitetura, segurança, acessibilidade e manutenção. Funciona com projetos criados com Next.js, Vite, Astro, TanStack, React Native e Expo, e é executado na raiz do projeto com npx.

Além de análises pontuais, a ferramenta pode instalar uma skill para ajudar agentes de programação, como Claude Code, Cursor, Codex e OpenCode, a encontrar e corrigir problemas em React. Também conta com um modo de CI que verifica cada pull request e aponta apenas os problemas introduzidos pelas alterações.

As regras são configuradas no arquivo doctor.config.ts, onde cada verificação pode ser ativada ou desativada. A ferramenta também pode gravar um trace de performance do Chrome DevTools a partir de um app React em execução em uma URL local específica.

Recursos principais

  • 01Verifica estado e efeitos, performance, arquitetura, segurança, acessibilidade e manutenção.
  • 02É compatível com projetos Next.js, Vite, Astro, TanStack, React Native e Expo.
  • 03Instala uma skill para agentes de programação, incluindo Claude Code, Cursor, Codex e OpenCode.
  • 04Executa em CI e aponta apenas os problemas introduzidos por cada pull request.
  • 05Permite configurar regras pelo doctor.config.ts.
  • 06Grava traces de performance do Chrome DevTools a partir de um app em execução.

Casos de uso

  • Encontrar problemas de performance e bugs de estado em uma codebase React antes do merge.
  • Permitir que um agente de programação verifique e corrija o próprio código React gerado.
  • Usar CI para bloquear pull requests e sinalizar novos problemas em React o quanto antes.
  • Analisar a performance de um app React em execução local com um trace de performance.

Início rápido

  1. 1

    Execute uma varredura a partir da raiz do seu projeto

    npx react-doctor@latest
  2. 2

    Instale a skill no seu agente de programação

    npx react-doctor@latest install

Antes de usar

  • A CLI coleta relatórios de falhas e dados de uso anônimos por padrão; para desativar a coleta, é preciso usar uma flag.
  • Os metadados do repositório indicam NOASSERTION como licença, embora o README informe MIT. Confira o arquivo de licença antes de confiar nessa informação.

Tópicos

Perguntas frequentes

O que é react-doctor?
Uma CLI e skill de agente que analisa codebases React em busca de problemas de estado, performance, segurança, acessibilidade e manutenção. O React Doctor é uma ferramenta de linha de comando que executa verificações determinísticas em código React e aponta problemas de estado e efeitos, performance, arquitetura, segurança, acessibilidade e manutenção. Funciona com projetos criados com Next.js, Vite, Astro, TanStack, React Native e Expo, e é executado na raiz do projeto com npx.
react-doctor é gratuito? Qual é a licença?
react-doctor é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
react-doctor ainda é mantido?
Manutenção ativa. O último commit de react-doctor foi em 19 de out. de 2026.
Para que posso usar react-doctor?
Encontrar problemas de performance e bugs de estado em uma codebase React antes do merge. Permitir que um agente de programação verifique e corrija o próprio código React gerado. Usar CI para bloquear pull requests e sinalizar novos problemas em React o quanto antes. Analisar a performance de um app React em execução local com um trace de performance.
Como instalar react-doctor?
Execute uma varredura a partir da raiz do seu projeto: npx react-doctor@latest Instale a skill no seu agente de programação: npx react-doctor@latest install
Onde consigo react-doctor?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/millionco/react-doctor

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados