Registry / testing / react-compiler-healthcheck

react-compiler-healthcheck

library1.0.0jsnpmunverified

A standalone health check script for React applications to detect violations of the Rules of React that could cause issues with the React Compiler (formerly React Forget). v1.0.0 is the initial release, distributed via npx, designed to be run once per codebase. It scans source files for patterns that break the Rules of React (e.g., mutating state, conditional hooks) and reports them. Unlike eslint-plugin-react-hooks which lints during development, this is a separate, one-time analysis tool. Maintained by the React team at Meta. Release cadence is low; expect minor updates for bug fixes.

testing

npm install react-compiler-healthcheck

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REACT-COMPILER-HEA

react-compiler-healthcheck

testingjavascriptv1.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (npx command)

✓ npx react-compiler-healthcheck@latest

This package is intended to be run via npx, not imported directly in code.

Running the health check script in your project root to detect React Compiler violations.

npx react-compiler-healthcheck@latest

Debug

Known issues

gotchaThe tool may report false positives for patterns that are safe but structurally similar to violations.

fix

Review each warning manually and consider adjusting code to be more explicit.

affects: >=1.0.0

gotchaDoes not replace eslint-plugin-react-hooks; both can be used complementarily.

fix

Run both eslint-plugin-react-hooks and this health check for comprehensive coverage.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'react-compiler-healthcheck'

Running the tool without npx, e.g., calling it as a standalone command.

fix

Use 'npx react-compiler-healthcheck@latest' instead.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

Resources

githubhttps://github.com/facebook/react ↗

packagehttps://www.npmjs.com/package/react-compiler-healthcheck ↗

homepagehttps://react.dev ↗