Developer Tooling · CLI tool
RN Upgrade Doctor
A CLI that scans your React Native or Expo project against a target version and tells you what will break before you upgrade, with the evidence for every finding.
Overview
Most React Native upgrades go the same way: bump the version, build, and discover one error at a time that Gradle, the Android Gradle Plugin, Kotlin, the NDK, Xcode or CocoaPods needs to change too. RN Upgrade Doctor reads your project first and reports what the target release requires against what you have. Findings are deterministic and cite their source, and where the data does not cover something it says so instead of guessing. It runs locally and sends nothing anywhere. The RN Upgrade Doctor web app adds compatibility checks for 150 tracked libraries.
Highlights
- Covers React Native 0.60 to 0.87 and Expo SDK 45 to 57
- Checks Node.js and React, Gradle, AGP, Kotlin, NDK, compileSdk and targetSdk, Xcode, iOS deployment target and CocoaPods
- Every finding cites its evidence and the date it was verified
- Runs fully locally; nothing about your project is uploaded
- CI-ready: --json output, --ci mode and stable exit codes (0, 1, 2)
- Config file to ignore rules or change severities; never executes project code
- Web app adds compatibility checks for 150 tracked libraries
Install
npx @mobilixir/rn-upgrade-doctor analyze --target 0.87 --path ./my-appWhy teams use it
Plan before you start
See every toolchain change the target release needs before you touch package.json, so you can estimate the upgrade honestly.
Evidence, not guesses
Each finding cites its source and verification date. Where the data does not cover something, the report says so.
Safe for CI and private code
Runs locally, never executes project code, and gives JSON output and stable exit codes for pipelines.
How it compares
vsReact Native Upgrade Helper
| Aspect | React Native Upgrade Helper | RN Upgrade Doctor |
|---|---|---|
| What it shows | The diff between two React Native template versions | What your project has against what the target release requires |
| Your toolchain | Not checked against your project | Node, React, Gradle, AGP, Kotlin, NDK, SDK levels, Xcode, deployment target and CocoaPods |
| Automation | A website you read | A CLI with --json output and exit codes |
| Best for | Applying the template changes | Knowing what to change before you begin; use both together |
vsBump the version and build
| Aspect | Bump the version and build | RN Upgrade Doctor |
|---|---|---|
| How problems appear | One build error at a time | The full list up front |
| Fix guidance | Search each error yourself | Remediation and the nearest confirmed version in every finding |
| Expo | Trial and error per SDK | SDK 45 to 57, from Expo's own bundled module data |
Let's talk
Need something like this in your app?
Tell us what you are building. You will get a reply within two business days.