Skip to content

About

Your agent writes bad React. This catches it

Topics

Resources

Stars

15.0k stars

Watchers

28 watching

Forks

Repository files navigation

React Doctor

version downloads

React Doctor runs deterministic checks on your code. It reports issues in state and effects, performance, architecture, security, accessibility, and maintainability.

Supports React projects built with Next.js, Vite, Astro, TanStack, React Native, and Expo.

Documentation →

Install

1. Run a scan

Run this command from your project root:

npx react-doctor@latest
Main.mp4

2. Install for agents

Install the skill to help your coding agent find and fix React issues:

npx react-doctor@latest install

Supports coding agents including Claude Code, Cursor, Codex, and OpenCode.

3. Run in CI

Scan each pull request and report the issues it introduces:

npx react-doctor@latest ci install

CI docs →

4. Configure rules

Choose rules and scan settings in doctor.config.ts.

Configuration docs →

Runtime performance traces

Record a Chrome DevTools performance trace while you interact with a running React app:

npx react-doctor@latest scan http://localhost:3000

Runtime trace docs →

Telemetry

The CLI collects crash reports and anonymous usage data. See Data use for details.

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

Contributing

Report an issue

MIT-licensed

About

Your agent writes bad React. This catches it

Topics

Resources

Stars

15.0k stars

Watchers

28 watching

Forks

Used by

Contributors

Languages