millionco/react-doctor
Your agent writes bad React. This catches it
What it solves
React Doctor is a deterministic scanner that identifies common mistakes in React codebases. It specifically targets issues related to state and effects, performance, architecture, security, and accessibility, which is particularly useful for catching "bad React" written by AI coding agents.
How it works
The tool scans JavaScript and TypeScript source files, as well as JavaScript within inline script blocks in HTML files. It can be run as a one-time audit via npx, integrated into CI/CD pipelines to review pull requests, or installed as a "skill" for AI coding agents (like Claude Code or Cursor) to help them learn from and fix issues.
Who it’s for
Developers using any React-based framework or library, including Next.js, Vite, TanStack, React Native, and Expo.
Highlights
- Deterministic scanning across multiple categories: state, effects, performance, architecture, security, and accessibility.
- AI Agent integration: allows coding agents to install the tool as a skill to improve their future code generation.
- CI/CD support: reviews pull requests and reports only the new issues introduced by a change.
- Broad compatibility: supports JS/TS and various React ecosystems.