What is React Doctor?
React Doctor is a deterministic scanner for React codebases. It finds issues across state and effects, performance, architecture, security, accessibility, and framework-specific patterns.
It is built for teams using React directly, Next.js, Vite, TanStack, React Native, Expo, and similar React stacks.
Why use it?
React Doctor gives you a repeatable way to find React problems that coding agents and normal lint rules often miss.
Use it to:
Audit a project locallyReview only files changed in a branchAdd sticky and inline PR commentsTeach coding agents the project's React quality barKeep staged-file feedback visible before commits
How it fits with linting
React Doctor is not a replacement for your existing lint setup. It can run as a CLI, as a CI check, or through standalone oxlint and ESLint plugins.
The CLI also respects existing ignore files and can adopt JSON ESLint or oxlint rule settings when available.
Typical workflow
1
Run React Doctor to setupPaste the following command into your terminal
npx react-doctor@latest2
Use verbose modeFor day-to-day work, continue with verbose mode
npx react-doctor@latest --verbose --diff