AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

upgrading-react-native

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.

Original source
callstackincubator
License
MIT
Pinned revision
59e9d17446a248b21d86f078fcd0bd2d36db1ca4

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read callstackincubator--upgrading-react-native at revision 59e9d17446a248b21d86f078fcd0bd2d36db1ca4, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 8

references/upgrade-verification.md


title: Upgrade Verification impact: HIGH tags: verification, regression, android, ios, navigation

Skill: Upgrade Verification

Manual and agent-assisted validation checklist after React Native and/or Expo upgrades.

Scope

  • Focus on behavior and UX regressions that static diffs cannot prove.
  • Keep checks small, repeatable, and tied to critical user flows.

Agent-Assisted Checks

Use agent-device for runnable app verification. If it is missing and device verification is needed, install it through the environment's approved/trusted path or ask the user to install or enable it.

  1. If the agent environment exposes an agent-device skill, read it before planning exact commands.
  2. If the agent-device CLI is available, follow its agent-device help workflow guidance.
  3. Open or install the upgraded app, drive each critical scenario, and verify with UI snapshots.
  4. Capture screenshots, logs, and pass/fail evidence for changed flows.
  5. Fall back to human validation for credentials, physical-device-only hardware, or profiler surfaces the agent cannot inspect.

Behavior Checks (Required)

  1. App launch and core journeys work on both iOS and Android.
  2. Navigation behavior is correct (forward/back stack, params, deep links, modal flows).
  3. Android edge-to-edge is visually correct (status bar, nav bar, safe area insets, keyboard overlays).
  4. Permissions and device APIs work (camera, location, notifications, file/media access).
  5. Background/restore paths work (app resume, push open, interrupted flows).

Build and Test Gates

  1. Run unit/integration tests and fix all upgrade-related failures.
  2. If target_version >= 0.81 and tests fail due to missing modules, add proper mocks.
    • Example (BackHandler mock removal): https://github.com/facebook/react-native/issues/52667#issuecomment-3094788618
  3. Build installable artifacts for both platforms.
  4. For Expo apps, run npx expo-doctor from expo-sdk-upgrade.md.

Evidence to Capture

  • Screen recordings/screenshots for changed flows.
  • List of verified scenarios and pass/fail status.
  • Follow-up fixes for any observed regressions.

Related Skills