Hornero OS documentation
Find a guide by the task you are trying to complete. This repository is the user and contributor handbook; implementation contracts stay with the Shell, CLI, and configuration repositories.
HorneroOS is an Arch-based operating-system family in development. Its Desktop edition is Wayland-first, with Hyprland as the default validated compositor and Niri as an experimental backend. There is no installable ISO or supported system installer yet. The release page and installation status are the current source for what can be installed.
Choose a path
| If you want to… | Start here |
|---|---|
| Understand release and installation status | Getting started |
| Use the desktop, apps, and Control Center | Desktop · Apps and workflows |
| Change themes, colors, or wallpaper | Appearance · Wallpapers |
| Choose a bar arrangement | Layouts |
| Lock, restart, or shut down the desktop session | Session menu |
| Find a keyboard shortcut | Shortcuts |
| Automate or inspect the system from a terminal | horneroctl |
| Diagnose graphics or device problems | Hardware · Troubleshooting |
| Understand editions and system boundaries | Architecture |
| Build, test, or contribute | Development |
| Design an interface for HorneroOS | Design language |
How these docs stay accurate
Steps describe behavior available in the released product unless they are
labelled Development or Preview. Package, installer, and release
availability can change; check the live release and installation pages before
following older notes. Commands are taken from horneroctl help and current
product configuration. Personal machine examples from the former dotfiles
wiki are not system requirements.
The website imports these Markdown pages at a reviewed commit and adds its own navigation, search, and responsive presentation. This repository owns the content; the website does not maintain a second copy.
Areas
- Getting started — release status and a safe first look.
- Desktop — appearance, wallpaper, layouts, compositors, and shortcuts.
- Apps and workflows — the configured application catalog and the paths that connect those tools to Hornero.
- horneroctl — supported command-line entry points.
- Hardware — device diagnostics and graphics guidance.
- Troubleshooting — recover from common failures.
- Architecture — editions, ownership, and data flow.
- Development — code, QA, and contribution paths.
- Design language — product identity, UI principles, source-of-truth map, and guidance for installer contributors.
License
MIT.