INC-2026-05-22-001: Hyprland v0.55.2 Config Breakage After Arch Upgrade

Incident Summary

Field Value

Detected

2026-05-22 (config error notification bar on Hyprland startup)

Mitigated

2026-05-22 (config fixes applied to dots-quantum)

Resolved

2026-05-22 (all 5 config errors cleared, hyprctl configerrors clean)

Duration

<1 hour

Severity

P3 (Medium) — Config error notification visible, 3 keybinds non-functional, compositor otherwise operational.

Impact

Five config errors displayed on every Hyprland startup. SUPER+T (togglesplit), SUPER+; / SUPER+' / SUPER+SHIFT+; (split ratio presets) keybinds non-functional. No crash, no input loss — cosmetic + partial keybind breakage.

Root Cause

Routine pacman -Syu upgraded Hyprland from 0.54.x to v0.55.2. Upstream removed dwindle:pseudotile config option (v0.55.0) and previously deprecated togglesplit and splitratio dispatchers (v0.54.0). dots-quantum config had not been updated to reflect these removals.

Environment

Property Value

Machine

modestus-aw (Arch Linux)

Hyprland (before)

0.54.x

Hyprland (after)

v0.55.2 (commit 39d7e20, 2026-05-16)

Aquamarine

0.11.0

Hyprlang

0.6.8

Hyprutils

0.13.1

Dotfiles Repo

dots-quantum (GNU Stow managed)

Config Path

~/.config/hypr/hyprland.conf → stow package

Timeline

Time Event

2026-05-22

Routine pacman -Syu upgrades Hyprland to v0.55.2 along with ecosystem packages (aquamarine, hyprlang, hyprutils, hyprcursor, hyprgraphics).

2026-05-22

Hyprland restart shows config error notification bar at top of screen. Per release notes, this is expected behavior for deprecated options.

2026-05-22

hyprctl configerrors reveals 5 errors across 3 categories: dwindle:pseudotile (line 242), togglesplit dispatcher (line 437), splitratio dispatcher (lines 740-742).

2026-05-22

Cross-referenced with prior incidents (INC-2026-04-07-002) and Hyprland config debugging codex. Consulted upstream release notes and GitHub discussions.

2026-05-22

Fixes applied to dots-quantum: removed pseudotile, migrated togglesplit to layoutmsg, commented splitratio binds (no upstream replacement). hyprctl reload && hyprctl configerrors confirms clean config.

Metadata

Field Value

Incident ID

INC-2026-05-22-001

Author

Evan Rosado

Created

2026-05-22

Last Updated

2026-05-22

Status

Resolved

Trigger

pacman -Syu upgraded Hyprland 0.54.x → v0.55.2

Fix Location

dots-quantum/hyprland/.config/hypr/hyprland.conf

Post-Incident Review

Complete