references/bare-quick-start.md
title: Bare React Native Quick Start impact: CRITICAL tags: react-native, brownfield, bare, setup, cocoapods, gradle
Skill: Bare React Native Quick Start
Prepare a bare React Native project for brownfield packaging and host integration.
Quick Command
npm install @callstack/react-native-brownfield
cd ios && pod install && cd ..
When to Use
- User explicitly chooses bare React Native path
- Project directly manages native iOS/Android folders
Prerequisites
- Bare RN app with working
ios/andandroid/ - CocoaPods and Gradle working
Step-by-Step Instructions
Progress checklist:
- [ ] Install package
- [ ] Install pods
- [ ] Create brownfield config
- [ ] Continue to bare platform packaging
- Install package in RN app root.
- Run
pod installfor iOS. - Create
brownfield.config.jsorbrownfield.config.jsonwith the iOS scheme and the Android module name and variant, so packaging commands stay short — see cli-and-config.md. - Continue with one platform packaging file:
Canonical Docs
Common Pitfalls
- Starting packaging before
pod install - Mixing Expo-only startup APIs into bare flow
Related Skills
- cli-and-config.md - CLI commands, config file, artifacts
- quick-start.md - Shared path-selection gate
- bare-ios-xcframework-generation.md - Bare iOS artifact generation
- bare-android-aar-generation.md - Bare Android artifact generation