Hyprland

Helm 0.1 targets Hyprland 0.56.2 or newer and writes only Lua configuration. Existing legacy .conf configurations remain read-only. To migrate, follow the current official Hyprland configuration guide, which explains the Lua entry point, syntax, and splitting configuration with require().

Alacritty

Helm preserves the root TOML document and adds one relative managed import under general.import. The generated fragment follows the official Alacritty configuration reference. Legacy YAML is detected but never rewritten.

Yazi

Helm discovers complete *.yazi flavor directories and losslessly updates only flavor.dark and flavor.light in the user's theme document. See Yazi's official flavor overview and theme reference.

Bars and shells

Helm generates a standalone Waybar JSONC configuration and GTK CSS without overwriting an existing bar. The format follows the official Waybar manual. Quickshell support is cooperative: Helm creates a separate named helm-settings configuration and leaves an existing root shell untouched, following the official Quickshell configuration guide.

Extended desktop state

Profiles use the current hyprpaper configuration and IPC contract and Hyprland Lua window-rule API. Startup entries follow the freedesktop autostart specification; MIME defaults are stored in the recommended user location and format from the MIME applications specification.