> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryoku.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Ryoku

> A hand-built Arch Linux Hyprland desktop and Omarchy alternative — a premium, pre-riced workstation with a Quickshell UI, the ryoku CLI, and a signed, reproducible package path.

**力と美のために** : *for the sake of power and beauty.*

Ryoku is a premium Arch workstation for capable desktops and laptops. It is
pre-riced, plugin-minded, and tuned for people who want a fast, polished daily
machine from first boot.

The desktop is [Hyprland](https://hypr.land/), driven by a
[Quickshell](https://quickshell.outfoxxed.me) UI: a morphing top bar (the pill),
the launcher, a control deck, the lock screen, and the Ryoku Settings control
center. Capture, updates, hardware, media, and developer tools are built into the
shell, not bolted on as tray-only scripts.

## Start here

<CardGroup cols={2}>
  <Card title="Install Ryoku" icon="download" href="/docs/install">
    Boot the signed ISO, verify it, and install onto your hardware.
  </Card>

  <Card title="Convert existing Arch" icon="right-left" href="/docs/convert">
    Already on Arch? Turn it into a Ryoku machine with one reversible command.
  </Card>

  <Card title="First boot" icon="power" href="/docs/first-boot">
    What you see after login, and where to click first.
  </Card>

  <Card title="Desktop tour" icon="compass" href="/docs/tour">
    Workspaces, the pill, launcher, control deck, and Ryoku Settings.
  </Card>
</CardGroup>

## What ships

* **Desktop**: a Hyprland session with a Quickshell pill, launcher, control deck, lock screen, and the Ryoku Settings control center.
* **The `ryoku` command**: one tool for updates, rollback, status, and self-healing, backed by signed packages and, on a btrfs root, snapper snapshots wrapped around every update.
* **Theming**: wallpaper-driven colors via wallust, plus switchable full-system themes (Ryoku Default, Catppuccin, Tokyo Night, Gruvbox, Nord, Rosé Pine, and more).
* **Daily-driver fit**: development, content work, media, notes, terminals, and container workflows on strong hardware.

## Go deeper

<CardGroup cols={2}>
  <Card title="Navigation & windows" icon="table-columns" href="/docs/navigation">
    Move between workspaces, tile and float windows, and drive the layout.
  </Card>

  <Card title="Ryoku Settings" icon="sliders" href="/docs/settings">
    The Hub: panels that edit your desktop live, with undoable preview.
  </Card>

  <Card title="Themes & wallpapers" icon="palette" href="/docs/theming">
    Wallust palettes, the shipped themes, and the wallpaper pickers.
  </Card>

  <Card title="The ryoku command" icon="terminal" href="/docs/cli">
    Update, roll back, snapshot, and heal your system from one CLI.
  </Card>
</CardGroup>