millionco/react-doctor

Project overview

Unlike AI-heuristic approaches, react-doctor deterministically scans source code to identify React-specific problems and equips coding agents with a learnable skill to avoid repeating the same mistakes.

Deployment

Refer to project documentation

License

License pending

Best for

• Developers and AI engineers working with React or React-enabled sites who need deterministic detection of React-specific code issues

Key capabilities

• Scans codebases to find React issues across state & effects, performance, architecture, security, and accessibility.
• Scans JavaScript, TypeScript, and Astro source files across React frameworks like Next.js, Vite, Astro, TanStack, React Native, and Expo.
• Installs a skill for coding agents to learn from found issues and fix them in the future.
• Reviews every pull request and reports only the issues introduced by the change.
• Allows configuration of which rules to run and how to run them in a configuration file.

Limitations and risks

• GitLab CI integration receives a gate-only scaffold instead of full support.
• The CLI reports crashes, basic run traces, and anonymous usage counters to Sentry by default. Teams with strict data-boundary requirements should account for this before adoption.

Getting started

• Run `npx react-doctor@latest` at the project root. The tool is executable directly via npx without explicit installation steps.

Evidence and sources

Open original GitHub project