Let coding agents diagnose and fix your React code.

This project is a security-hardened fork of React Doctor, published as react-dr.

The original react-doctor package was scanned with Sentinel: https://www.npmjs.com/package/create-sentinel-security

One command scans your codebase for security, performance, correctness, and architecture issues, then outputs a 0–100 score with actionable diagnostics.

react-dr detects your framework (Next.js, Vite, Remix, etc.), React version, and compiler setup, then runs two analysis passes in parallel:

1. Lint: Checks 60+ rules across state & effects, performance, architecture, bundle size, security, correctness, accessibility, and framework-specific categories (Next.js, React Native). Rules are toggled automatically based on your project setup.
2. Dead code: Detects unused files, exports, types, and duplicates.

Diagnostics are filtered through your config, then scored by severity (errors weigh more than warnings) to produce a 0–100 health score (75+ Great, 50–74 Needs work, <50 Critical).

Run this at your project root:

npx -y react-dr@1.0.0 .

Use --verbose to see affected files and line numbers:

npx -y react-dr@1.0.0 . --verbose

Use the local skill file and copy it to your agent's skills directory.

cp skills/react-dr/SKILL.md ~/.claude/skills/react-dr/SKILL.md

- uses: actions/checkout@v4
  with:
    fetch-depth: 0 # required for --diff
- run: npx -y react-dr@1.0.0 . --diff main --fail-on error

The command exits non-zero based on --fail-on and can gate CI directly.

Usage: react-dr [directory] [options]

Options:
  -v, --version     display the version number
  --no-lint         skip linting
  --no-dead-code    skip dead code detection
  --verbose         show file details per rule
  --score           output only the score
  -y, --yes         skip prompts, scan all workspace projects
  --project <name>  select workspace project (comma-separated for multiple)
  --diff [base]     scan only files changed vs base branch
  --fail-on <level> exit with error code on diagnostics: error, warning, none
  -h, --help        display help for command

Create a react-doctor.config.json in your project root to customize behavior:

{
  "ignore": {
    "rules": ["react/no-danger", "jsx-a11y/no-autofocus", "knip/exports"],
    "files": ["src/generated/**"]
  }
}

You can also use the "reactDoctor" key in your package.json instead:

{
  "reactDoctor": {
    "ignore": {
      "rules": ["react/no-danger"]
    }
  }
}

If both exist, react-doctor.config.json takes precedence.

CLI flags always override config values.

You can also use react-dr programmatically:

import { diagnose } from "react-dr/api";

const result = await diagnose("./path/to/your/react-project");

console.log(result.score); // { score: 82, label: "Good" } or null
console.log(result.diagnostics); // Array of Diagnostic objects
console.log(result.project); // Detected framework, React version, etc.

The diagnose function accepts an optional second argument:

const result = await diagnose(".", {
  lint: true, // run lint checks (default: true)
  deadCode: true, // run dead code detection (default: true)
});

Each diagnostic has the following shape:

interface Diagnostic {
  filePath: string;
  plugin: string;
  rule: string;
  severity: "error" | "warning";
  message: string;
  help: string;
  line: number;
  column: number;
  category: string;
}

git clone https://github.com/garrett/react-dr
cd react-dr
pnpm install
pnpm -r run build

Run locally:

node packages/react-dr/dist/cli.js /path/to/your/react-project

react-dr is MIT-licensed open-source software.