Desktop Stack Overview 🖥️¶

The desktop stack utilizes a Wayland ecosystem, customized with a dedicated shell architecture and theming engine.

Info

The desktop session relies on Hyprland operating under the Universal Wayland Session Manager (UWSM). The interface is provided by a custom Quickshell layer and styled using a JSON Theming Engine.

Architecture¶

graph TD
    A[greetd + tuigreet] -->|uwsm start hyprland.desktop| B[UWSM]
    B --> C[Hyprland]
    C --> D[Quickshell ii]
    C --> E[kitty & Apps]
    F[Theming Engine] -.->|Applies Colors| D
    F -.->|Applies Colors| C
    F -.->|Applies Colors| E

Core Components¶

Hyprland & Session: The Wayland compositor, keybind routing, idle/lock management, shaders, and a Quake-style drop-down terminal.
Quickshell Architecture: The "ii" Qt6/QML shell that replaces standard panels and runners. It handles panels, overview, OSD, and notifications.
Theming Engine: A global JSON-based color scheme generator and applier, accessible via Makefile targets.