Rendered from BUILDING.md in the repository — edit it there.

Building from source

Prerequisites (Rust, Node, WASM toolchain) are covered in SETUP.md.

Native (your host platform)

cargo build --release                   # Single command — that's it

Cross-platform

cargo build --release --target x86_64-pc-windows-msvc       # Windows
cargo build --release --target x86_64-apple-darwin          # macOS Intel
cargo build --release --target aarch64-apple-darwin         # macOS ARM

iPad / iOS

Built through the Tauri shell rather than cargo directly — Xcode owns the app target and links the Rust code as a static library. Requires the full Xcode app on macOS; run pnpm run ios:doctor to check.

pnpm run ios:init     # once — generates ui-desktop/src-tauri/gen/apple
pnpm run ios:dev      # run on an iPad simulator
pnpm run ios:build    # release .ipa → ui-desktop/src-tauri/gen/apple/build/arm64/
pnpm run ios:install  # build + install a standalone app on a connected iPad

ios:install is the one that leaves something usable behind: it compiles the UI into the app instead of pointing it at a dev server, signs it with a free Apple ID, and installs it over the existing pairing. The app is universal, so it works on an iPhone as well as an iPad. No paid Apple Developer Program — the trade is that a free signature lasts seven days, after which you re-run it.

Details → ui-desktop/README.md.

WebAssembly (browser slicer)

Requires: rustup target add wasm32-unknown-unknown and cargo install wasm-pack

wasm-pack build --target web --release

Or use the pnpm script (which handles schema generation too):

pnpm run hydrate               # Scene + type bindings
pnpm run hydrate:web-slicer    # Full WASM slicer (includes polygon clipping)

Using Makefile (Linux/macOS)

make build-release  build-windows  build-macos  build-wasm
make ios-doctor  ios-init  ios-dev  ios-build  ios-install      # macOS + Xcode only