# react-doctor | Million Software, Inc. | Knowledge Base | Instagit

Your agent writes bad React. This catches it

GitHub Stars: 8.4k

Repository: https://github.com/millionco/react-doctor

---

## Articles

### [How to Prevent Score Changes Across Different React-Doctor Version Upgrades](/millionco/react-doctor/what-strategies-can-be-employed-to-prevent-score-changes-across-different-react-doctor-version-upgrades)

Prevent React-Doctor score changes during upgrades. Pin versions, use offline mode, and freeze configs for deterministic results. Ensure stable project scores.

- Tags: best-practices
- Published: 2026-05-12

### [How to Use the `ignore.tags` Option for Design-Related Rules in React Doctor](/millionco/react-doctor/how-does-the-ignoretags-option-work-specifically-for-design-related-rules)

Learn how to use react-doctor's ignore.tags option to disable design-related rules. Silencing categories of checks is now easier with a single configuration entry.

- Tags: how-to-guide
- Published: 2026-05-12

### [What Is the `entryFiles` Configuration Option for Dead Code Detection in React Doctor?](/millionco/react-doctor/what-is-the-purpose-of-the-entryfiles-configuration-option-for-dead-code-detection)

Understand the entryFiles configuration option in React Doctor for accurate dead code detection. Prevent false positives by defining your application's starting files.

- Tags: api-reference
- Published: 2026-05-12

### [How react-doctor Automatically Detects the Framework and React Version](/millionco/react-doctor/how-does-react-doctor-automatically-detect-the-framework-and-react-version)

Discover how react-doctor automatically detects project frameworks and React versions by analyzing package.json, matching dependencies, and resolving monorepo references.

- Tags: how-to-guide
- Published: 2026-05-12

### [How `adoptExistingLintConfig` Integrates ESLint and Oxlint Configurations in React-Doctor](/millionco/react-doctor/how-does-adoptexistinglintconfig-interact-with-eslint-and-oxlint-configurations)

Learn how adoptExistingLintConfig integrates ESLint and Oxlint configs into React Doctor. It imports your rules, filters incompatibilities, and merges them for a better health score.

- Tags: internals
- Published: 2026-05-12

### [React Doctor ignore.overrides vs ignore.files vs ignore.rules: Configuration Guide](/millionco/react-doctor/what-are-the-distinctions-between-ignoreoverrides-ignorefiles-and-ignorerules)

Understand React Doctor's ignore.overrides, ignore.files, and ignore.rules. Learn how to configure exclusions for diagnostics and effectively manage your reports.

- Tags: configuration-guide
- Published: 2026-05-12

### [How to Diagnose Failed Suppressions Using the react-doctor --explain Flag](/millionco/react-doctor/how-does-the-explain-flag-help-diagnose-failed-suppressions)

Learn how the react-doctor --explain flag diagnoses failed suppressions. Uncover why rules fire and suppressions fail on specific lines with this powerful diagnostic tool.

- Tags: how-to-guide
- Published: 2026-05-12

### [How React-Doctor Determines Error Versus Warning Severity for Lint Rules](/millionco/react-doctor/what-criteria-determine-if-a-rule-is-classified-as-an-error-versus-a-warning-severity)

Learn how React Doctor classifies lint rule severity, differentiating errors from warnings based on oxlint analysis and optional internal promotion logic.

- Tags: internals
- Published: 2026-05-12

### [How React Doctor's Offline Mode Calculates Scores Without API Calls](/millionco/react-doctor/how-does-offline-mode-calculate-scores-without-making-api-calls)

Learn how React Doctor calculates quality scores offline using local diagnostic rules and penalty calculations. Discover this powerful feature for faster, network-free analysis.

- Tags: internals
- Published: 2026-05-12

### [How React‑Doctor Handles Scanning in a Monorepo with Multiple Projects](/millionco/react-doctor/how-does-react-doctor-handle-scanning-in-a-monorepo-with-multiple-projects)

Learn how React Doctor scans monorepos with multiple projects by automatically detecting roots, selecting projects, and unifying diagnostics across all subprojects.

- Tags: how-to-guide
- Published: 2026-05-12

### [textComponents vs rawTextWrapperComponents in react-doctor: Configuration Reference](/millionco/react-doctor/what-is-the-difference-between-textcomponents-and-rawtextwrappercomponents-in-react-doctor)

Understand the difference between textComponents and rawTextWrapperComponents in react-doctor. Learn how to configure component rules to suppress rn-no-raw-text violations.

- Tags: api-reference
- Published: 2026-05-12

### [How npx react-doctor install Equips AI Coding Agents with React Diagnostic Skills](/millionco/react-doctor/what-is-the-purpose-and-function-of-the-npx-react-doctor-install-command-for-agents)

Learn how npx react-doctor install empowers AI coding agents like Cursor and Claude with React diagnostic skills. Enable intelligent code fixes and explanations based on best practices.

- Tags: how-to-guide
- Published: 2026-05-12

### [React Doctor GitHub Actions Integration: How It Automatically Posts and Updates PR Comments](/millionco/react-doctor/how-does-the-github-actions-integration-work-to-post-pr-comments)

Integrate React Doctor with GitHub Actions to automatically post and update PR comments. Streamline your code review process with automated diagnostics directly in your pull requests.

- Tags: how-to-guide
- Published: 2026-05-12

### [How to Use the `diagnose()` API Programmatically for Custom Analysis in React Doctor](/millionco/react-doctor/how-do-i-use-the-diagnose-api-programmatically-for-custom-analysis)

Unlock custom analysis with react-doctor's diagnose() API. Programmatically discover React projects, run oxlint and knip runners in parallel, and get a health score.

- Tags: how-to-guide
- Published: 2026-05-12

### [Rule Categories and Severity Levels in React-Doctor: A Complete Diagnostic Guide](/millionco/react-doctor/what-are-the-different-rule-categories-and-their-associated-severity-levels-in-react-doctor)

Explore React-Doctor's rule categories like Architecture, Performance, and Security, with error and warning severity levels. Master diagnostic insights for your React app.

- Tags: deep-dive
- Published: 2026-05-12

### [How React-Doctor Detects Dead Code Using Knip: Internal Implementation](/millionco/react-doctor/how-does-react-doctors-dead-code-detection-using-knip-function-internally)

Discover how React-Doctor internally leverages Knip for dead code detection. Learn about its resilience layer, configuration sanitization, and automatic retries for robust unused code identification.

- Tags: internals
- Published: 2026-05-12

### [React Doctor Framework-Specific Rules for Next.js, React Native, and Vite](/millionco/react-doctor/what-framework-specific-rules-are-available-for-nextjs-react-native-and-vite)

Explore React Doctor's framework-specific lint rules for Next.js, React Native, and Vite. Enhance your code quality with specialized checks tailored for each environment. Find rules to improve your React projects.

- Tags: deep-dive
- Published: 2026-05-12

### [React-Doctor Inline Suppression System: How Stacked Comments Work](/millionco/react-doctor/what-is-the-mechanism-behind-the-inline-suppression-system-especially-with-stacked-comments)

Explore React-Doctor's inline suppression system. Learn how stacked disable-next-line comments build chains to suppress diagnostics efficiently. Understand suppression logic.

- Tags: internals
- Published: 2026-05-12

### [How react-doctor --diff Mode Detects and Scans Changed Files Against a Base Branch](/millionco/react-doctor/how-does-the-diff-mode-detect-and-scan-changed-files-compared-to-a-base-branch)

Discover how react-doctor --diff mode uses Git to scan only changed files against a base branch, optimizing your React code diagnostics.

- Tags: how-to-guide
- Published: 2026-05-12

### [How react-doctor --staged Mode Works: Internal Pre-Commit Scanning Architecture](/millionco/react-doctor/explain-the-internal-workings-of-react-doctors-staged-mode-for-pre-commit-scanning)

Discover how react-doctor's --staged mode works by scanning only Git staged files. Learn about its internal architecture for efficient pre-commit diagnostics.

- Tags: internals
- Published: 2026-05-12

### [How to Configure Ignore Rules Per File or Per Rule Using Overrides in React-Doctor](/millionco/react-doctor/how-can-i-configure-ignore-rules-per-file-or-per-specific-rule-using-overrides)

Learn how to configure React-Doctor ignore rules per file or specific rule using overrides. Target custom file glob patterns and limit suppression to individual rule IDs for precise control.

- Tags: how-to-guide
- Published: 2026-05-12

### [How React Doctor Calculates Its Internal Scoring Formula: The 100‑Point Penalty System](/millionco/react-doctor/how-does-react-doctor-calculate-its-internal-scoring-formula)

Discover how React Doctor's 100-point penalty system calculates its internal scoring formula. Learn the exact point deductions for errors and warnings.

- Tags: internals
- Published: 2026-05-12