Cross-Platform Builds

Ply apps run on Linux, macOS, Windows, Android, iOS, and the web. Desktop builds use cargo build. Other platforms use the plyx CLI.

🔗Desktop

No special tooling needed:

cargo build

Works on Linux, macOS, and Windows. Cross-compile with:

cargo build --target x86_64-pc-windows-gnu
cargo build --target x86_64-apple-darwin

🔗Web (WASM)

Build with plyx:

plyx web

This compiles to wasm32-unknown-unknown, generates an index.html, and bundles the JavaScript bridge (ply_bundle.js) which handles input, audio, networking, and accessibility on the web.

For CI pipelines, use --auto to skip interactive prompts:

plyx web --auto

🔗Android

Build an APK using Docker, this will download the 4GB docker image (2GB less than macroquad):

plyx apk

Or use a local NDK installation:

plyx apk --native

Install directly to a connected device:

plyx apk --install

🔗iOS

Generate an Xcode project:

plyx ios

Build for a physical device:

plyx ios --device

Generate a GitHub Actions workflow for CI:

plyx ios --actions

🔗plyx CLI reference

Command	What it does
plyx init	Scaffold a new Ply project
plyx add	Add features or fonts interactively
plyx web	Build for WASM
plyx apk	Build Android APK
plyx ios	Build for iOS
plyx completions	Generate shell completions

🔗Next steps

→ Advanced Topics