eslint-plugin-react-doctor

ESLint plugin for React Doctor. Diagnoses React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues.

This package owns the ESLint adapter for React Doctor's rule set. The underlying rules ship in oxlint-plugin-react-doctor (auto-installed as a transitive dependency). The full diagnostic CLI lives in react-doctor and pulls in this same rule set; install whichever fits your workflow.

Install

npm install --save-dev eslint-plugin-react-doctor

pnpm add -D eslint-plugin-react-doctor

yarn add -D eslint-plugin-react-doctor

Usage

Flat config (ESLint v9+):

import reactDoctor from "eslint-plugin-react-doctor";

export default [
  reactDoctor.configs.recommended,
  reactDoctor.configs.next,
  reactDoctor.configs["react-native"],
  reactDoctor.configs["tanstack-start"],
  reactDoctor.configs["tanstack-query"],
];

Pick only the configs that match your stack. recommended is framework-agnostic; the others layer on framework-specific rules.

Available configs

| Config | What it adds | | ---------------- | ------------------------------------------------------------- | | recommended | Framework-agnostic React rules. Safe baseline. | | next | Next.js specific rules (App Router, server components, etc.). | | react-native | React Native specific rules. | | tanstack-start | TanStack Start specific rules. | | tanstack-query | TanStack Query specific rules. | | all | Every rule across every framework, at recommended severity. |

Available rules

The full rule list lives in oxlint-config.ts. Rules are namespaced under react-doctor/*.

To override a rule:

import reactDoctor from "eslint-plugin-react-doctor";

export default [
  reactDoctor.configs.recommended,
  {
    rules: {
      "react-doctor/no-fetch-in-effect": "error",
      "react-doctor/no-derived-state-effect": "off",
    },
  },
];

Want the CLI too?

This package only ships the ESLint plugin. To run React Doctor's full scan (with scoring, JSON reports, agent integration, etc.), use the main CLI:

npx react-doctor@latest

See the React Doctor README for the full feature set.

License

MIT