Repolode
Submit
millionco

millionco/react-doctor

A CLI and agent skill that scans React codebases for state, performance, security, accessibility and maintainability issues.

View on GitHubWebsite
Stars
15,016
Forks
490
Open issues
314
Last commit
52 minutes ago

What is it?

React Doctor is a command-line tool that runs deterministic checks on React code and reports problems in state and effects, performance, architecture, security, accessibility, and maintainability. It works with projects built on Next.js, Vite, Astro, TanStack, React Native, and Expo, and is run from the project root with npx.

Beyond one-off scans, it can install a skill that helps coding agents such as Claude Code, Cursor, Codex, and OpenCode find and fix React issues. It also has a CI mode that checks each pull request and reports only the issues that the change introduces.

Rules are configured in a doctor.config.ts file, where individual checks can be enabled or disabled. The tool can also record a Chrome DevTools performance trace from a running React app at a given local URL.

Key features

  • 01Checks state and effects, performance, architecture, security, accessibility and maintainability.
  • 02Supports Next.js, Vite, Astro, TanStack, React Native and Expo projects.
  • 03Installs a skill for coding agents including Claude Code, Cursor, Codex and OpenCode.
  • 04Runs in CI and reports only issues introduced by each pull request.
  • 05Configurable rules through doctor.config.ts.
  • 06Records Chrome DevTools performance traces from a running app.

Use cases

  • Catching performance and state bugs in a React codebase before merging.
  • Letting a coding agent check and fix its own React output.
  • Gating pull requests in CI so new React issues are flagged early.
  • Profiling a locally running React app with a performance trace.

Quick start

  1. 1

    Run a scan from your project root

    npx react-doctor@latest
  2. 2

    Install the skill for your coding agent

    npx react-doctor@latest install

Things to know

  • The CLI collects crash reports and anonymous usage data by default, and you must opt out with a flag.
  • The repository metadata lists the license as NOASSERTION, although the README states MIT, so check the license file before relying on it.

Topics

#react#code-review#linting#static-analysis#nextjs#accessibility#ai-agents#agents#doctor#skill

FAQ

What is react-doctor?
A CLI and agent skill that scans React codebases for state, performance, security, accessibility and maintainability issues. React Doctor is a command-line tool that runs deterministic checks on React code and reports problems in state and effects, performance, architecture, security, accessibility, and maintainability. It works with projects built on Next.js, Vite, Astro, TanStack, React Native, and Expo, and is run from the project root with npx.
Is react-doctor free to use? What license does it have?
react-doctor is open source under the Other license. Check the license terms before using it in commercial products.
Is react-doctor still maintained?
Actively maintained. The last commit to react-doctor was on Oct 19, 2026.
What can I use react-doctor for?
Catching performance and state bugs in a React codebase before merging. Letting a coding agent check and fix its own React output. Gating pull requests in CI so new React issues are flagged early. Profiling a locally running React app with a performance trace.
How do I install react-doctor?
Run a scan from your project root: npx react-doctor@latest Install the skill for your coding agent: npx react-doctor@latest install
Where can I get react-doctor?
The source code and installation instructions are on GitHub: https://github.com/millionco/react-doctor

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects