Local iOS Build
Learn how to build your app locally for iOS
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:
Install Dependencies
Run the following command to install all required dependencies:
Run Prebuild
This step configures your native iOS project:
Start iOS Build
To run on the iOS simulator:
To run on a physical device:
To list available iOS devices and simulators, you can use:
Running on Physical Device
When running on a physical device:
- Make sure your device is connected via USB
- Trust your development certificate on the device
- 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.