iOS builds require macOS with Xcode (and Xcode Command Line Tools) installed. They cannot be performed on Linux or Windows.
- Yarn
- NodeJS (recommended version 22.18.0 or higher)
- Rust (https://www.rust-lang.org/tools/install)
- Rustup iOS targets (
rustup target add aarch64-apple-ios aarch64-apple-ios-sim x86_64-apple-ios) - CocoaPods (
sudo gem install cocoapods)
A single command produces ios/Zingolib.xcframework, a bundle that contains both
the device slice (arm64) and the simulator slice (arm64 + x86_64). Xcode picks
the right slice automatically based on the build destination — there is no
separate "device build" vs "simulator build".
- Clone the repository.
- Go to the cloned repo
cd zingo-mobile. - From the root of the project, install JS deps:
yarn - Build the Rust XCFramework:
yarn rust:ios— may take a long time on first run. - In the
iosdirectory, run:pod install
- In a terminal, run:
yarn start - In a separate terminal, run:
yarn iosYou can also open theiosdirectory in Xcode and run it there.