import { DocsFeatureList } from "@/components/docs/docs-feature-list";

# What is React Doctor?

React Doctor deterministically scans React code for correctness, performance, security, accessibility, and maintainability issues.

Run React Doctor from a project root:

```bash
npx react-doctor@latest
```

To check every pull request, install the CI workflow:

```bash
npx react-doctor@latest ci install
```

React Doctor supports React, Next.js, Vite, TanStack, React Native, Expo, and Preact projects.

## What you can do

<DocsFeatureList
  items={[
    {
      icon: "audit",
      text: "Find React issues locally",
      href: "/docs/overview/quickstart",
    },
    {
      icon: "branch",
      text: "Report only issues introduced by a branch",
      href: "/docs/overview/quickstart",
    },
    {
      icon: "audit",
      text: "Find complex components and hooks",
      href: "/docs/overview/react-maintainability",
    },
    {
      icon: "branch",
      text: "Find repeated JSX worth extracting",
      href: "/docs/overview/react-maintainability",
    },
    {
      icon: "annotations",
      text: "Comment on risky pull request changes",
      href: "/docs/ci-and-prs/github-actions-setup",
    },
    {
      icon: "teach",
      text: "Install the skill for coding agents",
      href: "/docs/getting-started/install-for-coding-agents",
    },
    {
      icon: "watch",
      text: "Check every pull request",
      href: "/docs/ci-and-prs/github-actions-setup",
    },
  ]}
/>

## How it fits with linting

React Doctor complements your existing lint setup. The CLI runs curated rules, built-in React maintainability analysis, and dependency supply-chain checks. Default maintainability findings focus on complex React functions and repeated JSX. You can opt into whole-project rules for unused files, exports, types, dependencies, and import cycles.

React Doctor also adopts JSON ESLint or oxlint configuration when present. Run the standalone plugins when you want React Doctor diagnostics inside an existing lint command.
