HamzaBlala49

HamzaBlala49 / react-compat-check

Public

A CLI tool to analyze React project dependencies and determine compatibility with a target React version.

13
0
100% credibility
Found Feb 05, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A command-line tool that analyzes React projects for dependency compatibility with target React versions, displays results in a table, and offers interactive or automatic upgrades for incompatible packages.

How It Works

1
🔍 Discover the checker

While planning to update your web app to a newer React version, you find this handy tool that checks if everything will work together.

2
📂 Open your project

Navigate to your app's main folder and start the tool with a simple command.

3
🎯 Pick your target version

Choose the React version you want to upgrade to from a friendly list of options.

4
🔍 Scan for compatibility

The tool quickly reviews all your app's components to see which ones match the new version.

5
📊 See the colorful results

Get a clear table showing green for good parts and red for ones needing updates, plus smart suggestions.

6
⚙️ Choose fixes

For any problem items, pick to update to the closest matching version, the newest one, or skip.

7
✅ Confirm and apply

Review the changes including any related parts, say yes, and watch it update your project safely.

🎉 All set!

Your app is now fully compatible with the new React version, ready to run smoothly.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 13 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is react-compat-check?

This TypeScript CLI tool scans your React project's dependencies to check compatibility with a target React version, like 19 or 18.2. Run `npx react-compat-check` in your project root for an interactive mode that shows a color-coded table of packages, their status, supported React ranges, and upgrade paths—including companion dependencies that must bump together. It outputs JSON for CI/CD, supports auto-fixing via `--fix nearest` or `--latest`, and auto-detects npm/yarn/pnpm.

Why is it gaining traction?

Unlike manual peer dep hunting or generic analyzers, it pinpoints exact nearest-compatible and latest versions from npm registry, flags required companion upgrades, and applies them interactively or in batch—saving hours on React migrations. CI-friendly exit codes and GitHub Actions integration make it dead simple for pipelines on Linux, Ubuntu, Windows, or Mac, while non-interactive flags like `--json` fit automated checks in GitHub repos.

Who should use this?

Frontend teams upgrading legacy React apps to 18+ or prepping for 19, especially in monorepos with tangled deps like react-redux or react-select. DevOps folks adding compat gates to GitHub Actions workflows, or solo devs auditing before pushes to GitHub repos. Skip if you're on React Native or non-npm ecosystems.

Verdict

Solid early tool with clean docs and tests, but only 12 stars and 1.0% credibility signal it's immature—test on non-prod first. Grab it for quick React audits if you're tired of semver guesswork.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.