react-native-brownfield-migration

The react-native-brownfield-migration skill provides a structured, incremental adoption workflow for integrating React Native or Expo into existing native iOS and Android applications. It helps teams plan and execute brownfield migration strategies using @callstack/react-native-brownfield, reducing the risk associated with full rewrites by enabling gradual feature-by-feature adoption. The skill guides users from project assessment and path selection through packaging React Native artifacts and integrating them into host applications while maintaining a controlled migration process.

Its core capabilities include migration planning, path selection between Expo and bare React Native workflows, initial setup with @callstack/react-native-brownfield, packaging React Native deliverables as XCFrameworks for iOS and AAR artifacts for Android, and integrating React Native surfaces into existing native applications. The skill also enforces migration guardrails such as selecting a single migration path, validating packaging steps before integration, using documented placeholders, preferring official documentation for platform-specific details, and keeping host applications isolated from direct React Native APIs when practical. It additionally supports startup and runtime verification through device-based validation workflows.

This skill is intended for mobile developers, platform engineers, technical leads, and teams responsible for modernizing existing native applications. Common use cases include planning phased migrations from native-only applications, introducing React Native into established mobile products, creating brownfield integration architectures, packaging reusable React Native artifacts for distribution, and incrementally rolling out React Native-powered screens or features without disrupting existing native functionality.