# React Native Brownfield Migration

Implements an accepted incremental brownfield migration from native iOS or Android to...

- Repository: https://github.com/callstackincubator/agent-skills (1694 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-10-08
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add callstackincubator/agent-skills --skill react-native-brownfield-migration -g -a claude-code -y`
Codex: `npx skills add callstackincubator/agent-skills --skill react-native-brownfield-migration -g -a codex -y`
Cursor: `npx skills add callstackincubator/agent-skills --skill react-native-brownfield-migration -g -a cursor -y`
Gemini CLI: `npx skills add callstackincubator/agent-skills --skill react-native-brownfield-migration -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add callstackincubator/agent-skills`

## Description

Implements an accepted incremental brownfield migration from native iOS or Android to React Native or Expo using @callstack/react-native-brownfield. Use after the brownfield path has been selected, when setting up the integration, packaging XCFramework or AAR artifacts, or adding React Native surfaces to native hosts.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](../assess-react-native-migration/SKILL.md) 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:

The rest: https://github.com/callstackincubator/agent-skills/blob/HEAD/skills/react-native-brownfield-migration/SKILL.md