Index of every page on this site: llms.txt
All skills
neha avatar

/upgrades

@eb9f097
Run it yourself

Upgrade React Native, adopt the New Architecture, and keep native dependencies aligned. Use when bumping React Native, enabling the New Architecture, or updating a native module.

Use this Skill: https://skilld.dev/gh/neha/rn-developer-skills/upgrades

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈47 tokens for metadata: the name and description. ≈829 when used: this file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈189 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Upgrades Skill

Applicability

  • Platforms: iOS and Android
  • React Native: 0.76+ (New Architecture interop assumed unless a checklist item says otherwise)

When to Use

  • Bumping React Native, React, or the native toolchain
  • Turning the New Architecture on, or adding a native module to an app that already uses it
  • A native dependency release forces an app upgrade

Severity

  • Merge-blocking: the app does not boot on iOS or Android, or a native module stays on a version that does not match this React Native bump.
  • Should-fix: how the bump is split, and smoke-test notes.

Guidance

Version jump

  • The target version's changelog is read for breaking changes before the bump
  • A jump across several minors is split so each step boots, instead of one unreviewed leap
  • JS dependencies that ship native code are upgraded in the same change as the React Native bump
  • Both iOS and Android build and launch on the new version before the change is merged

Incorrect:

react-native 0.72 → 0.78 in one pull request, Android left for a follow-up

Correct:

One minor at a time, each step building and launching on iOS and Android, with native modules upgraded in the same step

Native version matrix

  • Kotlin, the iOS deployment target, and the Android min SDK match what the target React Native version requires
  • Codegen has been run for native modules that need it, and the app still builds
  • Libraries that ship native code and must move together are upgraded in the same change (navigation screens, gesture handler, and animated-on-the-UI-thread libraries)

Incorrect:

react-native bumped; react-native-screens and react-native-gesture-handler left on the previous major

Correct:

react-native, screens, and gesture-handler moved to the versions that release says belong together, then both platforms launched

New Architecture

  • New native modules use the New Architecture interop; a new bridge module is not added without a written reason
  • Modules that do not support the New Architecture are listed, and the feature is hidden or replaced until they do
  • The app is exercised on a New Architecture build for any screen that touches a native module changed in the upgrade

After the bump

  • A smoke pass covers launch, sign-in, and the critical path this app cannot ship without
  • Release build settings still point at the right environment (see release-and-updates)
  • Source maps or debug symbols still upload so crashes from the new version can be read (see observability)

Anti-Patterns

Anti-Pattern Risk Fix
Editing generated native projects by hand during an upgrade The next bump overwrites the fix Put the change in config the upgrade keeps
Pinning an old native module "for now" with a patch that skips its install Crashes on the New Architecture Upgrade or replace the module in the same change

Pitfalls

  • A JS-only bump can still break when a dependency's native pod or gradle version moved.
  • Hermes and the JS engine flags change between versions; a crash that exists only in release is easy to miss on a debug smoke test.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts9d3 checks · Risk SAFE
  • Gen Agent Trust Hub9d

    The skill is a collection of best practices and checklists for React Native upgrades. It contains no executable code, network requests, or data processing functions. No security risks were identified.

  • Socket9d

    No alerts

  • Snyk9d

    Risk: LOW · No issues

Signed by skilld at eb9f097. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 2 months ago
version
1.1.0
platforms
[
  "ios",
  "android"
]
react-native-version
0.76+
Other metadata
tags
[
  "react-native",
  "upgrades",
  "new-architecture"
]

README badge

README badge for neha/rn-developer-skills/upgrades