What is React Doctor?

React Doctor deterministically scans React code for correctness, performance, security, accessibility, and maintainability issues.

Run React Doctor from a project root:

npx react-doctor@latest

To check every pull request, install the CI workflow:

npx react-doctor@latest ci install

React Doctor supports React, Next.js, Vite, TanStack, React Native, Expo, and Preact projects.

What you can do

Find React issues locally Report only issues introduced by a branch Find complex components and hooks Find repeated JSX worth extracting Comment on risky pull request changes Install the skill for coding agents Check every pull request

How it fits with linting

React Doctor complements your existing lint setup. The CLI runs curated rules, built-in React maintainability analysis, and dependency supply-chain checks. Default maintainability findings focus on complex React functions and repeated JSX. You can opt into whole-project rules for unused files, exports, types, dependencies, and import cycles.

React Doctor also adopts JSON ESLint or oxlint configuration when present. Run the standalone plugins when you want React Doctor diagnostics inside an existing lint command.