millionco/react-doctorPublic

Your agent writes bad React. This catches it

AI summary: A deterministic CLI tool that audits React codebases for state, performance, architectural, and security issues.

Star on GitHub

Stars: 14.3K; +19 today
Forks: 455
Watchers: 24
Open issues: 12
Open PRs: 50
Contributors: ~17
Commits: 1.3K
Branches: 776

TypeScriptOtherCreated Feb 13, 2026Last push todayLatest release oxlint-plugin-react-doctor@0.9.6+93 stars this week+135 this month

Star history

since Feb 15, 2026

14.3K stars as of Aug 7, 2026, tracked back to Feb 15, 2026. Historical curve reconstructed from public GitHub event archives, calibrated to the current total.

Contribution activity

commits per day, last 52 weeks

1,330 commits in the last yearLessMore

Signals and awards

derived from tracked data

Widely adopted
14,301 stars
Very active
1,330 commits in 52 weeks
Continuous integration
Automated checks passing
Repeat trending
5 trending appearances

What react-doctor does

React Doctor scans JavaScript and TypeScript source files to identify suboptimal patterns in React applications. It acts as an automated reviewer, finding deterministic issues related to state management, side effects, performance bottlenecks, and accessibility. Designed to work across any React framework including Next.js, Vite, and React Native, it can even inspect inline script blocks in HTML files. It integrates directly into CI pipelines to review pull requests, reporting only new regressions rather than backlog issues.

React Doctor is tailored for frontend developers, engineering managers, and AI coding agent operators who want to maintain high code quality standards. It assumes familiarity with React fundamentals and Node.js environments.

Deterministic Scanning: Analyzes your codebase for concrete, proven issues across multiple architectural domains.
Framework Agnostic: Seamlessly works with Next.js, Vite, TanStack, React Native, and Expo without extra setup.
CI Pipeline Integration: Reviews pull requests and posts a summary comment highlighting only newly introduced problems.
Agent Skill Mode: Provides an installable skill allowing coding agents to learn from issues and fix them autonomously.
Inline Script Inspection: Capable of parsing and scanning JavaScript embedded directly within standard HTML files.
Opt-out Telemetry: Provides transparent, anonymous usage reporting with a simple flag to disable it entirely.

Where teams use it

Automated pull request reviews

Engineering teams can catch React anti-patterns in CI before they merge into the main branch, reducing technical debt.

Performance bottleneck detection

Frontend developers can proactively discover state and effect loops that cause unnecessary re-renders.

Coding agent enhancement

AI agent operators can install the React Doctor skill, teaching tools like Claude Code and Cursor to write cleaner React.

Accessibility compliance auditing

QA engineers can scan codebases for missing ARIA attributes and structural accessibility flaws directly from the terminal.

Getting started: npx react-doctor@latest

README

main branch

Your agent writes bad React, this catches it.

React Doctor deterministically scans your codebase and finds issues across state & effects, performance, architecture, security, and accessibility.

Works across React frameworks and React-enabled sites - Next.js, Vite, Astro, TanStack, React Native, Expo, you name it.

Website →

Install

1. Quick start

Run this at your project root to get an audit.

npx react-doctor@latest

Main.mp4

2. Install for agents

Once you have an audit, you can install the skill for your coding agent to learn from the issues and fix them in the future.

npx react-doctor@latest install

Works with Claude Code, Cursor, Codex, OpenCode, and many more.

3. Run in CI

React Doctor reviews every pull request and reports only the issues your change introduced, not your existing backlog. Set it up with one command:

npx react-doctor@latest ci install

This adds the workflow, scans every pull request, and posts a summary comment. Change the gate, scan scope, and comments anytime with react-doctor ci config, and bump the action with react-doctor ci upgrade. GitHub Actions is fully supported; GitLab CI gets a gate-only scaffold.

CI docs →

4. Configure rules

You can configure which rules to run and how to run them in doctor.config.ts.

Learn more →

Telemetry

The CLI reports crashes, basic run traces, and anonymous usage counters to Sentry to help us fix bugs and prioritize work.

We collect:

Environment: CLI version, platform, Node version
Invocation: which command, package manager, and run context (whether it's local vs. CI vs. coding agent)
Project shape: framework, React version, TypeScript, project size (NO file contents)
Rules fired: rule names and counts only (e.g. react-doctor/no-array-index-as-key) (NO code or specific findings)
De-minified React Doctor CLI stack traces

To opt out, run: npx react-doctor@latest --no-telemetry

Contributing

Issues welcome!

MIT-licensed

View on GitHub

Recent activity

commits and pull requests

refactor: simplify internals across the workspaceOpen
#1590 by aidenybai · updated 5h ago
chore: version packagesMerged
#1586 by github-actions[bot] · updated 6h ago
chore: version packages (#1586)
github-actions[bot] committed 59ae70b · 6h ago
test(fuzz): preserve React Bench diagnostic callsitesMerged
#1600 by aidenybai · updated 9h ago
test(fuzz): preserve React Bench diagnostic callsites (#1600)
aidenybai committed 65d4f46 · 9h ago
fix: recognize browser media lifecyclesMerged
#1599 by aidenybai · updated 10h ago
fix: recognize browser media lifecycles (#1599)
aidenybai committed a4d2c5c · 10h ago
fix(rules): preserve state effect provenanceMerged
#1597 by aidenybai · updated 16h ago
fix(rules): preserve state effect provenance (#1597)
aidenybai committed 4ffeb2c · 16h ago
fix(rule): harden effect cleanup regressions (#1596)
aidenybai committed d62caa5 · 16h ago
fix(rule): harden effect cleanup regressionsMerged
#1596 by aidenybai · updated 16h ago
fix: no-loading-flag-reset-outside-finally false positive with trailing resetDraft
#1595 by skoshx · updated 23h ago

Releases and announcements

186 total

react-doctor@0.9.6react-doctor@0.9.6Aug 7, 2026
### Patch Changes - [#1592](https://github.com/millionco/react-doctor/pull/1592) [`ac4e51f`](https://github.com/millionco/react-doctor/commit/ac4e51f6856dd0df091eed6ed4cdcb190574c048) Thanks [@aidenybai](https://github.com/aidenybai)! - Detect React Compiler transforms passed through an installed `@rolldown/plugin-babel` wrapper. - [#1584](https://github.com/millionco/react-doctor/pull/1584) [`4b03b15`](https://github.com/millionco/react-doctor/commit/4b03b15cbea22802990e66a4dbbf067930be6361) Thanks [@aidenybai](https://github.com/aidenybai)! - Load standard JavaScript and TypeScript Knip configuration files when collecting dead-code entry and ignore patterns. - [#1596](https://github.com/millionco/react-doctor/pull/1596) [`d62caa5`](https://github.com/millionco/react-doctor/commit/d62caa575f9bcf2abca5933f2899dd907a3d344d) Thanks [@aidenybai](https://github.com/aidenybai)! - Accept trailing loading resets after non-rethrowing catch handlers, and preserve effect-local cleanup helpers with deterministic false-positive and false-negative fuzz replay. - Updated dependencies [[`2b8bc5c`](https://github.com/millionco/react-doctor/commit/2b8bc5cf9d524594e3a3f923e463f128fd4a7ac9), [`a4
oxlint-plugin-react-doctor@0.9.6oxlint-plugin-react-doctor@0.9.6Aug 7, 2026
### Patch Changes - [#1599](https://github.com/millionco/react-doctor/pull/1599) [`a4d2c5c`](https://github.com/millionco/react-doctor/commit/a4d2c5c8bf45c3e38f07e2ffbaae5fe4443f5754) Thanks [@aidenybai](https://github.com/aidenybai)! - Recognize browser media capability and playback lifecycles without masking unrelated prop-driven state adjustments, and resolve cross-file helpers with dotted basenames. - [#1597](https://github.com/millionco/react-doctor/pull/1597) [`4ffeb2c`](https://github.com/millionco/react-doctor/commit/4ffeb2cb71e195d21d3693a7578be7f74ee78d19) Thanks [@aidenybai](https://github.com/aidenybai)! - Fix derived-state detection through render-updated refs and avoid flagging finite timer lifecycle shutdowns as prop-driven state adjustments. - [#1596](https://github.com/millionco/react-doctor/pull/1596) [`d62caa5`](https://github.com/millionco/react-doctor/commit/d62caa575f9bcf2abca5933f2899dd907a3d344d) Thanks [@aidenybai](https://github.com/aidenybai)! - Accept trailing loading resets after non-rethrowing catch handlers, and preserve effect-local cleanup helpers with deterministic false-positive and false-negative fuzz replay.
eslint-plugin-react-doctor@0.9.6eslint-plugin-react-doctor@0.9.6Aug 7, 2026
### Patch Changes - [#1599](https://github.com/millionco/react-doctor/pull/1599) [`a4d2c5c`](https://github.com/millionco/react-doctor/commit/a4d2c5c8bf45c3e38f07e2ffbaae5fe4443f5754) Thanks [@aidenybai](https://github.com/aidenybai)! - Recognize browser media capability and playback lifecycles without masking unrelated prop-driven state adjustments, and resolve cross-file helpers with dotted basenames. - [#1597](https://github.com/millionco/react-doctor/pull/1597) [`4ffeb2c`](https://github.com/millionco/react-doctor/commit/4ffeb2cb71e195d21d3693a7578be7f74ee78d19) Thanks [@aidenybai](https://github.com/aidenybai)! - Fix derived-state detection through render-updated refs and avoid flagging finite timer lifecycle shutdowns as prop-driven state adjustments. - Updated dependencies [[`a4d2c5c`](https://github.com/millionco/react-doctor/commit/a4d2c5c8bf45c3e38f07e2ffbaae5fe4443f5754), [`4ffeb2c`](https://github.com/millionco/react-doctor/commit/4ffeb2cb71e195d21d3693a7578be7f74ee78d19), [`d62caa5`](https://github.com/millionco/react-doctor/commit/d62caa575f9bcf2abca5933f2899dd907a3d344d)]: - oxlint-plugin-react-doctor@0.9.6
deslop-js@0.9.6deslop-js@0.9.6Aug 7, 2026
### Patch Changes - [#1589](https://github.com/millionco/react-doctor/pull/1589) [`2b8bc5c`](https://github.com/millionco/react-doctor/commit/2b8bc5cf9d524594e3a3f923e463f128fd4a7ac9) Thanks [@aidenybai](https://github.com/aidenybai)! - Expose declared dependencies conservatively excluded from unused-dependency analysis and explain the exclusions in human-readable CLI output.
deslop-cli@0.9.6deslop-cli@0.9.6Aug 7, 2026
### Patch Changes - [#1589](https://github.com/millionco/react-doctor/pull/1589) [`2b8bc5c`](https://github.com/millionco/react-doctor/commit/2b8bc5cf9d524594e3a3f923e463f128fd4a7ac9) Thanks [@aidenybai](https://github.com/aidenybai)! - Expose declared dependencies conservatively excluded from unused-dependency analysis and explain the exclusions in human-readable CLI output. - Updated dependencies [[`2b8bc5c`](https://github.com/millionco/react-doctor/commit/2b8bc5cf9d524594e3a3f923e463f128fd4a7ac9)]: - deslop-js@0.9.6

Commits per week

last 52 weeks

1.3K commits in the last 52 weeks.

When work happens

weekday and hour

Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Date	List	Rank	Stars gained
Feb 21, 2026	daily	#25	+141
Feb 20, 2026	daily	#13	+145
Feb 19, 2026	daily	#5	+312
Feb 18, 2026	daily	#4	+406
Feb 17, 2026	daily	#13	+174

freeCodeCamp/freeCodeCamp
freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.
453.6K stars · TypeScript
openclaw/openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
385.5K stars · TypeScript
openclaw/openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
384.4K stars · TypeScript
openclaw/openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
384.4K stars · TypeScript
openclaw/openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
384.4K stars · TypeScript
react/react
The library for web and native user interfaces.
247.1K stars · JavaScript