Your Agent Writes Bad React.
This Catches It.

One command scans your codebase and outputs a 0 to 100 health score with actionable diagnostics

75
View on GitHub Get Started

3 Stars • MIT License

React Codebase Health Issues

Performance Bottlenecks

Unnecessary re-renders, inefficient state management, and missed optimization opportunities

Bugs & Anti-patterns

Common React pitfalls and code smells that lead to runtime errors and maintenance nightmares

Dead Code Accumulation

Unused files, exports, types, and duplicate code that bloats your codebase

React Doctor Solution

Health Score Dashboard

Get an instant 0-100 score with detailed breakdown of code quality metrics

Smart Diagnostics

Categorized issues: state & effects, performance, architecture, security, accessibility

Actionable Insights

Specific recommendations and code examples to fix identified issues

Powerful Features

Codebase Scanning

Scan your entire codebase with a single command, getting a comprehensive health score and actionable diagnostics

Framework Agnostic

Works seamlessly with Next.js, Vite, and React Native with automatic rule adjustment

Dead Code Detection

Identifies unused files, exports, types, and duplicates to keep your codebase clean

Security & Accessibility

Checks for security vulnerabilities and accessibility issues in your React code

AI Agent Integration

Install skills for coding agents like Claude Code, Cursor, and Codex to prevent bad code

GitHub Actions

Composite action for CI pipelines with PR comments and score output for build control

How It Works

1. Install & Scan

Run npx -y react-doctor@latest at your project root to get instant health diagnostics

2. Review Diagnostics

Receive a comprehensive health score and categorized issues with actionable recommendations

3. Fix Issues

Address the identified problems to improve your code quality and maintainability

4. Continuous Improvement

Integrate with CI/CD pipelines and AI coding agents to maintain code quality automatically

Framework Support

Automatically adapts to your React ecosystem

React
Next.js
Vite
React Native

Smart Configuration

Rules automatically adjust based on your project's framework and React version

Flexible Setup

Configure via react-doctor.config.json or package.json, respects .gitignore and inline comments

AI Agent Integration

Prevent Bad Code Before It's Written

Install React Doctor as a skill for your AI coding assistant to catch issues in real-time

Claude Code
Cursor
Codex
OpenCode

Install AI Skill

Run this command to integrate with your AI coding agent:

npx -y react-doctor@latest install

GitHub Actions Integration

CI/CD Pipeline Integration

Use the composite action to automatically check code quality in your pull requests 

uses: millionco/react-doctor@latest
with:
  diff: 'true'
  github-token: ${{ secrets.GITHUB_TOKEN }}

PR Comments

Automatically posts findings as comments on pull requests

Score Output

Outputs health score for build control and quality gate

Flexible Configuration

Multiple Configuration Options

react-doctor.config.json

Dedicated configuration file for advanced settings

package.json

Configure using the reactDoctor key in your package.json

ESLint Integration

Use the ESLint flat-config plugin for seamless integration

Smart Ignore Handling

React Doctor automatically respects:

  • .gitignore files
  • ESLint/Olint disable comments
  • Framework-specific exclusions

Get Started in Seconds

Install React Doctor and start improving your React codebase today

Install for Project Scanning

npx -y react-doctor@latest

Scans your entire codebase and provides health diagnostics

Install for AI Agent Integration

npx -y react-doctor@latest install

Integrates with AI coding assistants to prevent bad code

Ready to Improve Your React Code?

Join thousands of developers who trust React Doctor for their code quality

Star on GitHub Try It Now