upgrading-react-native

Automate React Native upgrades by applying rn-diff-purge diffs and migrating native configurations.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ravnhq/typescript-blueprint --skill upgrading-react-native-ravnhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-react-native
Source: https://github.com/ravnhq/typescript-blueprint/tree/main/.agents/skills/upgrading-react-native
Command: npx skills add https://github.com/ravnhq/typescript-blueprint --skill upgrading-react-native-ravnhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and Gradle changes, and handling breaking API updates. Use when upgrading React Native, bumping RN version, updating from RN 0.x to 0.y, or migrating Expo SDK alongside a React Native upgrade.

Core Features & Use Cases

  • Automates the end-to-end upgrade workflow by retrieving and applying canonical diffs, updating dependencies, and aligning related packages.
  • Migrates native configurations for iOS and Android, including CocoaPods and Gradle changes.
  • Handles breaking API changes and Expo SDK considerations when upgrading RN.
  • Provides guidance and references to common upgrade pitfalls and validation steps.

Quick Start

Run the upgrade planner for your app directory, generate a plan, and apply diffs and dependency updates as directed.

Frequently Asked Questions about upgrading-react-native

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade React Native to a newer version?

To upgrade React Native, this Skill automates applying rn-diff-purge template diffs, updating package.json dependencies, and migrating native iOS and Android configurations across target versions.

What is the best way to migrate Expo SDK alongside a React Native upgrade?

The best way to migrate Expo SDK during a React Native upgrade is to use an automated workflow that aligns related packages and handles breaking API changes specific to your target versions.

How does rn-diff-purge help with React Native upgrades?

rn-diff-purge provides canonical template diffs that this Skill retrieves and applies to your project, ensuring accurate native configuration merges and dependency updates during React Native upgrades.

Can I use this to update native iOS and Android configurations for React Native?

Yes, this Skill migrates native iOS and Android configurations by resolving CocoaPods and Gradle changes, ensuring your native projects align with the upgraded React Native version.

What are common pitfalls when upgrading React Native versions?

Common React Native upgrade pitfalls include unresolved CocoaPods or Gradle changes, unhandled breaking API updates, and misconfigured native settings, which this Skill addresses through guided validation steps.

Does this Skill handle breaking API changes during a React Native version bump?

Yes, it handles breaking API changes by applying canonical rn-diff-purge diffs and providing references to common upgrade pitfalls and post-upgrade validation checks.