Skip to content

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-app

Why 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

RN Upgrade Doctor compared with React Native Upgrade Helper
AspectReact Native Upgrade HelperRN Upgrade Doctor
What it showsThe diff between two React Native template versionsWhat your project has against what the target release requires
Your toolchainNot checked against your projectNode, React, Gradle, AGP, Kotlin, NDK, SDK levels, Xcode, deployment target and CocoaPods
AutomationA website you readA CLI with --json output and exit codes
Best forApplying the template changesKnowing what to change before you begin; use both together

vsBump the version and build

RN Upgrade Doctor compared with Bump the version and build
AspectBump the version and buildRN Upgrade Doctor
How problems appearOne build error at a timeThe full list up front
Fix guidanceSearch each error yourselfRemediation and the nearest confirmed version in every finding
ExpoTrial and error per SDKSDK 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.