peach ios
Start a simulator on iOS. The platform picks the device: your current device is kept when it is already an iOS model, otherwise the default iOS device is used. Use —remote with your app folder, or a prebuilt bundle, to run it on the production service and open its viewer.
Options
| flag | description |
|---|---|
--stream | stream this local simulator to your team until Ctrl+C |
--watch | keep a remote simulator connected to your Metro server until Ctrl+C |
--device <model> | pick a specific iOS device model. an Android model here is refused by name rather than silently overriding the platform |
--remote | build the app folder, or take the bundle, and run it on a remote simulator with its viewer open |
Examples
Run Your App
From your Expo or React Native app’s folder:
Peach builds the app with the app’s own bundler, compiles its Expo modules, Nitro modules and C++ TurboModules on your Mac, and ships them with the bundle. Your Metro config needs no changes. Remote Android simulators do not load compiled Kotlin modules yet.
A prebuilt bundle also works. Build it with expo export:embed or react-native bundle through withPeach(config) from peachsim/metro, which records your installed package versions, then pass the file. Peach compiles the native modules of the app folder above the bundle, or of --native-project <app-dir>: