Team adding React quality gate to CI
Adds react-doctor to CI with `--diff main` so every PR only fails when it introduces new React health regressions, not for pre-existing baseline issues.
Open source alternative to SonarQube
Last verified
Analyze React apps for state, performance, architecture, security, and accessibility issues with a local CLI health score and CI-friendly fixes.
Adds react-doctor to CI with `--diff main` so every PR only fails when it introduces new React health regressions, not for pre-existing baseline issues.
Runs `npx react-doctor@latest` before submitting a PR to get a prioritized issue list without waiting for reviewer feedback.
Runs `npx react-doctor@latest install` into their Cursor setup so AI-generated code gets validated against React best practices before it is committed.
Does a quick health check on a client's inherited codebase to scope a React refactor engagement before committing to a timeline.
Monitors health score over time as a lightweight code quality signal while building a Next.js app without a full SonarQube setup.
Coding agents and junior developers routinely introduce React anti-patterns: effects that run too often, components with too many responsibilities, missing accessibility attributes, and performance-killing render patterns. Standard ESLint configurations catch syntax-level issues but miss architectural patterns that only become visible when you look at the full component tree. Manual code reviews for React best practices are time-consuming, inconsistent, and do not run automatically in CI.
Outputs a 0-100 health score with severity breakdown: 75+ is great, 50-74 needs work, under 50 is critical
Covers five diagnostic surfaces: state and effects, performance, architecture, security, and accessibility
Detects your framework (Next.js, Vite, React Native) and adjusts its rule set automatically
GitHub Actions composite action ships in the repo with sticky PR comments, configurable fail-on threshold, and a score output for downstream steps
`--diff <base>` mode scopes diagnostics to changed files only, catching new regressions without requiring a clean baseline
`npx react-doctor@latest install` writes best-practice rules into your coding agent's config files so it stops writing the bad patterns in the first place
react-doctor is an MIT-licensed React quality scanner for teams using coding agents to generate or modify React code.
vs CodeRabbit: CodeRabbit reviews pull requests across hosted Git platforms and IDE or CLI workflows, with AI comments and paid team plans. react-doctor is narrower and local-first: it runs through the npx react-doctor latest command, scores React code from 0 to 100, and flags issues across state, effects, performance, architecture, security, and accessibility.
vs Snyk Code: Snyk Code focuses on static application security testing and security findings across supported languages. react-doctor should not replace a security scanner; it is better for React-specific regressions, framework-aware rules, agent instruction installation, and PR score gates in Next.js, Vite, and React Native projects.
vs SonarQube Cloud: SonarQube Cloud is broader code quality and security governance for many languages and repositories. react-doctor is better when the immediate problem is AI-generated React code that violates framework patterns, but SonarQube is still the stronger choice for organization-wide quality gates, centralized reporting, and cross-language policy.
Setup from the root of a React project:
npx react-doctor@latest install
Run an audit locally:
npx react-doctor@latestOnly if you configure it to. By default, --fail-on error exits non-zero when error-severity rules fire. Set --fail-on none for advisory mode that reports findings but never blocks a build.
Yes. React Doctor detects your project framework and applies React Native-specific rules automatically. Framework detection is based on your installed packages and project structure.
npx react-doctor@latest install writes React best-practice rules into the config files for your detected coding agents (Claude Code, Cursor, Codex, and 50+ others). This teaches the agent the rules upfront so it avoids writing code that react-doctor would flag.
Alternative to
Moderne
Automate code migrations at scale using a pattern-matching DSL
Alternative to
CodeDashboard
Review code changes as architecture maps, not line diffs
Alternative to
Lovable
Local, open-source AI app builder with your own API keys
Alternative to
Dust
Open source AI workspace with sandboxed apps and Gatekeeper security
Typed errors, DI, and concurrency for TypeScript
Alternative to
AWS Amplify
Open source Apple SDK for Firebase auth, data, push and crashes
Featured
Alternative to
Superhuman
AI email assistant that drafts replies and clears your inbox
Alternative to
Grok Bot
AI teammates you own: your keys, your model, your machine.
Alternative toClaude Managed Agents
Open-source agent deployment API. Self-host or use Omnara Cloud.
The projects we add and every new guide. Free, unsubscribe any time.