millionco / react-doctor

Let coding agents diagnose and fix your React code. One command scans your codebase for security, performance, correctness, and architecture issues, then outputs a **0–100 score** with actionable diagnostics. See it in action → https://github.com/user-attachments/assets/07cc88d9-9589-44c3-aa73-5d603cb1c570 How it works React Doctor detects your framework (Next.js, Vite, Remix, etc.), React version, and compiler setup, then runs two analysis passes **in parallel**: • **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. • **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). Install Run this at your project root: Use to see affected files and line numbers: Install for your coding agent Teach your coding agent all 47+ React best practice rules: Supports Cursor, Claude Code, Amp Code, Codex, Gemini CLI, OpenCode, Windsurf, and Antigravity. GitHub Actions | Input | Default | Description | | -------------- | ------- | ----------------------------------------------------------------- | | | | Project directory to scan | | | | Show file details per rule | | | | Workspace project(s) to scan (comma-separated) | | | | Base branch for diff mode. Only changed files are scanned | | | | When set on events, posts findings as a PR comment | | | | Node.js version to use | The action outputs a (0–100) you can use in subsequent steps. Options Configuration Create a in your project root to customize behavior: You can also use the key in your instead: If both exist, takes precedence. Config options | Key | Type | Default | Description | | -------------- | ------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------- | | | | | Rules to suppress, using the format shown in diagnostic output (e.g. , , ) | | | | | File paths to exclude, supports glob patterns ( , ) | | | | | Enable/disable lint checks (same as ) | | | | | Enable/disable dead code detection (same as ) | | | | | Show file details per rule (same as ) | | | | — | Force diff mode ( ) or pin a base branch ( ). Set to to disable auto-detection. | CLI flags always override config values. Node.js API You can also use React Doctor programmatically: The function accepts an optional second argument: Each diagnostic has the following shape: Scores for popular open-source projects | Project | Score | Share | | ------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------- | | tldraw | **84** | view | | excalidraw | **84** | view | | twenty | **78** | view | | plane | **78** | view | | formbricks | **75** | view | | posthog | **72** | view | | supabase | **69** | view | | onlook | **69** | view | | payload | **68** | view | | sentry | **64** | view | | cal.com | **63** | view | | dub | **62** | view | Contributing Want to contribute? Check out the codebase and submit a PR. Run locally: License React Doctor is MIT-licensed open-source software.