# Ryoku

## Docs

- [Branding](https://docs.ryoku.dev/docs/branding.md)
- [Customization inventory](https://docs.ryoku.dev/docs/customization-inventory.md)
- [Customize](https://docs.ryoku.dev/docs/customize.md): Themes, wallpapers, bar items, keybinds. Most customization is reachable from Settings; advanced changes live in well-marked config files.
- [First boot](https://docs.ryoku.dev/docs/first-boot.md): What you see after installing Ryoku and logging in for the first time, and where to go next.
- [Install Ryoku](https://docs.ryoku.dev/docs/install.md): Download the signed ISO, verify it, and install it onto your hardware via the Ryoku Configurator + archinstall front end.
- [Iso build recipe](https://docs.ryoku.dev/docs/iso-build-recipe.md)
- [Keybindings](https://docs.ryoku.dev/docs/keybindings.md)
- [Maintenance](https://docs.ryoku.dev/docs/maintenance.md)
- [Omarchy heritage](https://docs.ryoku.dev/docs/omarchy-heritage.md)
- [Release pipeline](https://docs.ryoku.dev/docs/release-pipeline.md)
- [Security tools](https://docs.ryoku.dev/docs/security-tools.md): OpenVPN sidebar, SecPulse indicator, in-shell polkit agent. Workflow primitives built into Ryoku's shell.
- [Desktop tour](https://docs.ryoku.dev/docs/tour.md): How Niri's scrollable workspaces work, what each bar island does, and which sidebar is which.
- [Troubleshooting](https://docs.ryoku.dev/docs/troubleshoot.md): Where logs live, common boot/login/network issues, and how to report a useful bug.
- [Ui patterns](https://docs.ryoku.dev/docs/ui-patterns.md)
- [Updates](https://docs.ryoku.dev/docs/updates.md): How Ryoku updates itself, how the in-shell update overlay works, and how to roll back.
- [Vision](https://docs.ryoku.dev/docs/vision.md)
- [Ryoku](https://docs.ryoku.dev/index.md): An opinionated Arch desktop for cybersecurity learning and personal labs. Niri compositor, Quickshell UI, signed offline ISO.