These instructions assume you have already cloned the repository and completed the initial setup from the Quickstart guide.

​
Package Manager

While these instructions use bun, you can also use npm or yarn. Simply replace bun with your preferred package manager in the commands.

​
Build Steps

Follow these steps to build and run your iOS app locally:
1

Install Dependencies

Run the following command to install all required dependencies:
bun install
2

Run Prebuild

This step configures your native iOS project:
bun preBuild
3

Start iOS Build

To run on the iOS simulator:
bun ios
To run on a physical device:
bun ios -d {device_id}
To list available iOS devices and simulators, you can use:
xcrun xctrace list devices

​
Running on Physical Device

When running on a physical device:
  1. Make sure your device is connected via USB
  2. Trust your development certificate on the device
  3. Unlock your device before running the build command
The first build might take longer as it needs to compile all native dependencies. Subsequent builds will be faster.