Wawona is a native Wayland compositor. You do not need Nix to run a binary.
Versioning is CalVer YY.M.D (see GitHub tags like v26.8.12). Older 0.x marketing versions are retired.
macOS is not a store feature target. Do not wait for a Mac store listing.

Get a build
- Download for GitHub assets (
Wawona-{calver}-{platform}-{arch}.{ext}: dmg, ipa, apk, AppImage) when av*tag ships. See Prebuilt binary naming. - TestFlight / Play beta. Find testing links on the Wawona Discord. Play ships internal (CI smoke) on every green
mastertip. Closed Alpha is the interim external channel while Open testing waits on Play production access. When Open testing is live, Discord carries the public opt-in link. Store filenames include the build number; see the same naming doc. - Apple family schemes exist for iOS, iPadOS, tvOS, watchOS, and visionOS. Android and Linux too.


First run
Open Wawona. Create or pick a Machine. Start it. Use Focus to show the compositor.
Before tapping Weston panel icons or nested clients, set Touch Input Type to Multi-Touch (iOS family) or turn Touchpad Mode off (Android). See Usage. Typing follows the host keyboard and IME. There is no layout picker. See Keyboard and IME.
Extra software
Two catalogs. Pick a lane at repo.wawona.io/search.
- App Store / Play: search wasm, then
wpm installin the Wawona shell. Wasm only. - Jailbroken iOS: add
https://repo.wawona.io/in Sileo (rootless and rootful). - Sideloaded Android: add the same URL in Termux
apt. Termux is not jailbreak and not Play.
See Packages.
Build from source
Contributors: Compilation, Nix, reproducible direnv + Nix, and AI + MCP. You need Nix, Xcode on Apple, and local signing inputs in ignored .envrc.local for signed iOS family builds.
nix run .#wawona-macos
nix run .#wawona-ios
nix run .#wawona-android
nix run .#wawona-linuxOther attributes: wawona-macos-desktop-host, wawona-watchos-app-sim, wawona-tvos-sim, wawona-visionos-sim.
Report a bug
If a machine does nothing after Start, copy logs from Settings → About and open a GitHub issue. See Report a bug.