react-doctor — What is it?

React Doctor is a tool that assesses the quality of React codebases, providing a health score and actionable diagnostics to improve code quality.

⭐ 8,998 Stars 🍴 284 Forks TypeScript MIT Author: millionco
Source: README View on GitHub →

Why it matters

React Doctor is gaining attention due to its ability to enforce React best practices, offering a comprehensive code quality assessment, and its integration capabilities with various coding agents and CI/CD pipelines. Its unique feature of providing a health score and actionable diagnostics sets it apart from other code quality tools.

Source: Synthesis of README and project traits

Core Features

Health Score

Scans codebases and outputs a 0 to 100 health score with actionable diagnostics, categorizing issues across state & effects, performance, architecture, security, accessibility, and dead code.

Source: README
Framework Compatibility

Works with Next.js, Vite, and React Native, adapting rules based on the framework and React version in use.

Source: README
Integration with Coding Agents

Integrates with coding agents like Claude Code, Cursor, Codex, OpenCode, and more, to teach best practices and prevent bad code from being written.

Source: README
GitHub Actions Support

Supports GitHub Actions for automated code quality checks on pull requests, with findings posted as comments and scores available for subsequent steps.

Source: README

Architecture

The architecture of React Doctor is modular, with separate components for scanning, diagnostics, and reporting. It uses a combination of static analysis and rule-based systems to evaluate code quality, with a focus on adaptability to different React frameworks and versions.

Source: Code tree + dependency files

Tech Stack

infra: Node.js, npm/pnpm  |  key_deps: @changesets/cli, turbo, typescript, vite-plus  |  language: TypeScript  |  framework: React

Source: Dependency files + code tree

Quick Start

Run this at your project root: ```bash npx -y react-doctor@latest . ```
Source: README Installation/Quick Start

Use Cases

React Doctor is suitable for developers and teams working on React applications, particularly those using Next.js, Vite, or React Native. It is useful for ensuring code quality, identifying and fixing issues, and integrating with CI/CD pipelines for automated code quality checks.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Comprehensive code quality assessment with actionable diagnostics.
  • Strength 2: Compatibility with multiple React frameworks and versions.
  • Strength 3: Integration capabilities with coding agents and CI/CD pipelines.

Limitations

  • Limitation 1: May require configuration for specific project needs.
  • Limitation 2: The effectiveness of the tool depends on the quality of the rules and configurations.
Source: Synthesis of README, code structure and dependencies

Latest Release

react-doctor@0.0.38 (2026-04-17): GitHub Action improvements, including offline input and fail-on options.

Source: GitHub Releases

Verdict

React Doctor is a valuable tool for React developers and teams aiming to maintain high code quality and efficiency. Its comprehensive assessment and integration capabilities make it a strong choice for ensuring robust and maintainable React applications.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-09 18:30. Quality score: 85/100.

Data sources: README, GitHub API, dependency files