Getting startedBuild and run with niri or Umbriel, then set up layer rules and keybinds.
ConceptsIsland, Presentations, Surfaces and Modules: the vocabulary the rest of the docs use.
SurfacesBrowse the Island's interactive Surfaces, from Media to Files and Auth.
ConfigurationWhere config lives, how layers merge, and every key by area.
CLIControl every Surface, switch and session action from a script or a keybind.
IntegrationsDictation, Google Calendar, agent hooks and the SDDM login screen.
Kanade supports niri and Umbriel and is pre-1.0: expect breaking changes, and read known gaps for compositor-specific limits before relying on a feature. Umbriel starts Kanade through its unchanged autostart entry; a recovery parent restarts the rendering shell after an exit. Read Running Kanade for observed lock recovery, recovery limits and remaining live acceptance gaps.
The design records live in the repository, indexed in Decisions.