react-native-brownfield-migration

1# Migrating to React Native
2 
3Use 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](../assess-react-native-migration/SKILL.md) first.
4 
5## Overview
6 
7Prescriptive workflow for incremental adoption of React Native in existing native apps using `@callstack/react-native-brownfield`, from initial setup through phased host integration.
8 
9- Expo track
10- Bare React Native track
11 
12Use one track per task unless the user explicitly asks for migration or comparison.
13 
14## Migration Strategy
15 
16Use this strategy for brownfield migration planning and execution:
17 
181. Assess app state and select Expo or bare path.
192. Perform initial setup with `@callstack/react-native-brownfield`.
203. Package RN artifacts (`XCFramework`/`AAR`) from the RN source app.
214. Integrate one RN surface into the host app and validate startup/runtime.
225. Repeat integration by feature/screen for incremental rollout.
23 
24## Agent Guardrails (Global)
25 
26Apply these rules across all reference files:
27 
281. Select one path first (Expo or bare) and do not mix steps.
292. Use placeholders from the docs (`<framework_target_name>`, `<android_module_name>`, `<registered_module_name>`) and resolve from project files.
303. Validate each packaging command before moving to host integration.
31…