Wawona is a native Wayland compositor for macOS, iOS, and Android. Choose a section below to get started.
Getting Started
Getting Started Install Nix, build and run Wawona, set up your Team ID for iOS signing Usage Guide Run Weston, connect Wayland clients, remote apps via Waypipe Compilation Reference All build commands, project generators, debug builds, dev shell
Architecture & Design
Architecture Rust core, FFI layer, native frontends, threading model, 68 protocols macOS Implementation Metal rendering, IOSurface zero-copy, Liquid Glass, native window management Android Architecture Kotlin/JNI frontend, Vulkan rendering, Dropbear SSH bundling
Configuration & Features
Settings Reference All settings across macOS, iOS, and Android with platform defaults Waypipe Guide Remote Wayland apps over SSH — OpenSSH, libssh2, Dropbear transports Graphics Drivers Vulkan/OpenGL driver selection, CTS validation, iOS static drivers