callstackincubator avatar

React Native Brownfield Migration

If you're sitting on a native iOS or Android app and want to adopt React Native incrementally without a full rewrite, this skill walks you through the brownfield migration using Callstack's tooling. It covers both Expo and bare React Native paths, helping you package your RN code as XCFrameworks or AARs and integrate them surface by surface into your existing app. The guardrails are solid: it forces you to pick one path upfront instead of mixing workflows, uses proper placeholders, and keeps your host app isolated from React Native internals. Honestly refreshing to see migration guidance that treats this as a phased rollout rather than a big bang deployment.

skills.sh installs
5.6K
GitHub stars
1.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add callstackincubator/agent-skills --skill react-native-brownfield-migration --agent claude-code

Installs into .claude/skills of the current project.

Files

Migrating to React Native

Use this skill only after the decision to adopt brownfield migration has been made. When the user is still choosing between brownfield, greenfield, a checkpoint-based path, defer, or no migration, use assess-react-native-migration first.

Overview

Prescriptive workflow for incremental adoption of React Native in existing native apps using @callstack/react-native-brownfield, from initial setup through phased host integration.

  • Expo track
  • Bare React Native track

Use one track per task unless the user explicitly asks for migration or comparison.

Migration Strategy

Use this strategy for brownfield migration planning and execution:

  1. Assess app state and select Expo or bare path.
  2. Perform initial setup with @callstack/react-native-brownfield.
  3. Package RN artifacts (XCFramework/AAR) from the RN source app.
  4. Integrate one RN surface into the host app and validate startup/runtime.
  5. Repeat integration by feature/screen for incremental rollout.

Agent Guardrails (Global)

Apply these rules across all reference files:

Sponsors

Details

Repository
github.com/callstackincubator/agent-skills
Categories
Frontend Development, AI & Agent Building, Mobile Development
First seen
Apr 16, 2026

More from callstackincubator/agent-skills

All 10
1nexu-io avatarui-ux-pro-maxnexu-io/open-designCatalog-only UI/UX Pro Max entry. The full upstream templates, data, and search workflow are not bundled in OpenDesign.5.5Kskills.sh installs
2forcedotcom avatarexperience-ui-bundle-salesforce-data-accessforcedotcom/sf-skillsMUST activate when a uiBundles/*/src/ project does ANY Salesforce record operation — reading, creating, updating, deleting, or caching/refreshing query results.5.3Kskills.sh installs
3forcedotcom avatarexperience-ui-bundle-features-generateforcedotcom/sf-skillsMUST activate when the project contains a uiBundles/*/src/ directory and the user wants to add a pre-built feature — such as authentication (login, logout, prot5.1Kskills.sh installs
4claude-office-skills avatarlayout-analyzerclaude-office-skills/skills>4.7Kskills.sh installs
5dpearson2699 avatarswiftui-layout-componentsdpearson2699/swift-ios-skillsBuild SwiftUI layouts using stacks, grids, lists, scroll views, forms, and controls. Covers VStack/HStack/ZStack, LazyVGrid/LazyHGrid, List with sections and sw4.4Kskills.sh installs
6jeffallan avatarvue-expert-jsjeffallan/claude-skillsCreates Vue 3 components, builds vanilla JS composables, configures Vite projects, and sets up routing and state management using JavaScript only — no TypeScrip4.3Kskills.sh installs