Running on iOS

iOS uses Xcode schemes instead of CLI scripts to differentiate between Development and Production environments.

Prerequisites

Before running on iOS, install CocoaPods dependencies:

make menu
# → 2. Run pod install (iOS)

Or manually:

cd ios && pod install && cd ..

Running via Xcode

Open the workspace file in Xcode:

open ios/YourProject.xcworkspace

Always open the .xcworkspace file, not the .xcodeproj file. Opening the wrong one will cause CocoaPods dependencies to not be found.

Select your scheme from the scheme picker at the top:

Scheme	Environment
`Dev App`	`.env.development`
`App`	`.env.production`

Select your target device or simulator.
Press ⌘ + R to run.

Plist Setup (Important)

RNJet generates two additional plist files alongside Info.plist:

Info-Dev.plist
Info-Prod.plist

You must add these to Xcode manually or Dev/Prod behavior will be inconsistent.

Steps

Right-click your project in the Xcode file navigator
Select Add Files to [ProjectName]
Select both Info-Dev.plist and Info-Prod.plist
✅ Check "Copy items if needed"
Click Add

Whenever you edit Info.plist (adding permissions, URL schemes, etc.), remember to apply the same changes to both Info-Dev.plist and Info-Prod.plist.

Troubleshooting

Build failing after pod install?

Try a clean pod install:

cd ios
rm -rf Pods Podfile.lock
pod install

Scheme not visible in Xcode?

Go to Product → Scheme → Manage Schemes and make sure both Dev App and App are listed and have the Shared checkbox checked.

iOS