react-doctor: what it is, what problem it solves & why it's gaining traction

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 operates as a CLI that scans the codebase to find issues based on a set of configurable rules. It can be run as a one-time audit, integrated into a CI/CD pipeline to review pull requests and report only new issues, or installed as a "skill" for AI coding agents (such as Claude Code, Cursor, and Codex) to help them learn from mistakes and improve their output.

Who it’s for

React developers and teams using any React-based framework or library (including Next.js, Vite, TanStack, React Native, and Expo) who want to maintain code quality and provide feedback loops for their AI coding assistants.

Highlights

• Deterministic scanning for state, effects, performance, architecture, security, and accessibility.
• Integration with AI coding agents to improve their code generation.
• CI/CD support for GitHub Actions and GitLab CI to gate pull requests.
• Framework agnostic across the React ecosystem.
• Configurable rules via doctor.config.ts.