What is React Doctor?
React Doctor is an MIT-licensed diagnostic tool for React codebases. Its deterministic checks cover state and effects, performance, architecture, security, accessibility, and maintainability. Supported project frameworks include Next.js, Vite, Astro, TanStack, React Native, and Expo.
The command-line tool runs from a project directory and can be added to CI to report issues introduced by pull requests. Teams can scan an entire codebase, focus on changed code, configure rule severity, and compare findings against saved reports. An optional skill helps coding agents investigate and address diagnostics.
For runtime investigations, React Doctor records Chrome DevTools performance traces while a user reproduces an interaction. The CLI collects crash reports and anonymous usage data, with an opt-out option. Runtime traces contain potentially sensitive local application data and require appropriate handling.
Key capabilities
- Code diagnostics Checks React code for correctness, security, accessibility, performance, architecture, and maintainability issues.
- Change-focused analysis Scans full projects or selected change scopes and compares findings against saved baseline reports.
- Rule configuration Adjusts individual rules, categories, severity levels, and visibility in scores, pull request comments, and CI gates.
- Agent workflow Provides a coding-agent skill for regression checks, diagnostic triage, and code cleanup.
- Runtime tracing Records Chrome DevTools traces and produces structured summaries for investigating browser and React component performance.
- Design audits Runs focused checks for UI composition, typography, interaction, accessibility, and motion.
Where React Doctor fits
React Doctor fits into local development, pre-commit review, and pull request checks for teams maintaining React applications, including those using coding agents. Developers can inspect existing issues, check whether changes introduce regressions, or run a focused design audit. Before adoption, teams should review enabled rules, severity settings, and which findings affect CI gates and health scores.
Runtime tracing supports investigations into slow interactions in a running application. Teams should verify Chrome availability and any remote-debugging requirements, decide how sensitive traces will be stored, and review telemetry settings. Baseline comparisons require matching tool versions, rules, and relevant scan settings.
Install
npx react-doctor@latestReviews of React Doctor
Be the first to share your experience with React Doctor.
Write a review
Loading review form…
Alternatives to React Doctor
ARTEMISARTEMIS is an Apache-2.0 Android automation agent from Google. It drives real phones and emulators over ADB from natural-language tasks, with a web console, CLI, Python SDK and an MCP server for AI coding assistants.
BrunoOpen-source API client for REST, GraphQL, gRPC, WebSocket and SOAP that saves collections as .bru or OpenCollection YAML files on disk. No account or cloud sync; teams share collections through Git and run them in CI with the bru CLI.FFlociFloci is a free, open-source local AWS emulator for development, testing and CI that works with AWS SDKs, the AWS CLI, Terraform, CDK and OpenTofu.