react-doctor — What is it?

React Doctor is a tool that analyzes React codebases to provide a health score and actionable diagnostics, promoting best practices and identifying issues across state & effects, performance, architecture, security, and accessibility.

⭐ 13,302 Stars 🍴 423 Forks TypeScript MIT Author: millionco
Source: README View on GitHub →

Why it matters

React Doctor is gaining attention due to its focus on improving React code quality by catching bad practices and providing detailed diagnostics. It addresses the pain point of maintaining code quality in large codebases, fills the gap by offering a comprehensive analysis tool, and stands out with its integration capabilities with various coding agents and CI/CD pipelines.

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 by severity and suggesting improvements.

Source: README
Framework Compatibility

Works seamlessly 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 enforce best practices at the source of code generation.

Source: README
GitHub Actions Support

Includes a GitHub Action for automated code analysis on pull requests and pushes, with options for PR feedback modes and blocking mechanisms.

Source: README

Architecture

The architecture of React Doctor is modular, with separate components for rule application, severity control, and diagnostic collection. It leverages TypeScript for type safety and integrates with ESLint and oxlint for rule enforcement. The project is structured into packages, with a clear separation of concerns between core functionality and auxiliary tools like GitHub Actions.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) @types/node turbo typescript oxlint eslint-plugin-react-hookseslint-plugin-… Health Score Framework CompatibilityFramework Compatibi… Integration with Coding AgentsIntegration with Co… GitHub Actions SupportGitHub Actions Supp… react-doctor Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguageTypeScriptFrameworkReact, Next.js, Vite, React Native
@types/nodeturbotypescriptoxlinteslint-plugin-react-hooks
GitHub Actions for CI/CD integration
Source: Dependency files + code tree

Quick Start

Run this at your project root: ```bash npx 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 code reviews, CI/CD pipelines, and as a tool for coding agents to enforce best practices.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Comprehensive analysis covering multiple aspects of React code quality.
  • Strength 2: Integration with popular frameworks and coding agents.
  • Strength 3: Actionable feedback and health scoring for quick issue identification.

Limitations

  • Limitation 1: May require additional setup for full functionality, such as installing specific coding agents.
  • Limitation 2: The effectiveness 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 an 'offline' input for restricted environments.

Source: GitHub Releases

Verdict

React Doctor is a valuable tool for maintaining high-quality React codebases, particularly for teams that prioritize code quality and want to automate the process of identifying and fixing issues. It is well-suited for organizations with a focus on React development and CI/CD integration.

Source: Synthesis

Frequently Asked Questions

What is react-doctor?

React Doctor is a tool that analyzes React codebases to provide a health score and actionable diagnostics, promoting best practices and identifying issues across state & effects, performance, architecture, security, and…

What are the main features of react-doctor?

react-doctor's core features include: Health Score, Framework Compatibility, Integration with Coding Agents, GitHub Actions Support.

Why is react-doctor trending?

React Doctor is gaining attention due to its focus on improving React code quality by catching bad practices and providing detailed diagnostics.

What is react-doctor used for?

React Doctor is suitable for developers and teams working on React applications, particularly those using Next.js, Vite, or React Native.

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-22 11:07. Quality score: 85/100.

Data sources: README, GitHub API, dependency files