By name: configure-hyprland description: Audit, fix, and validate Hyprland configurations in a hybrid Nix/Home Manager environment. Use when identifying syntax errors, applying modern rules, or verifying configuration integrity.
Configure Hyprland
Workflow
- consult Hyprland Wiki for modern syntax and dispatchers
- identify legacy syntax and map to modern patterns using syntax-patterns.md
- update
home/desktop/hyprland/default.nix(Nix settings) orcfg/hyprland.conf(raw config) - run validate-hypr-config.sh to assemble and headless-test the configuration
- debug specific "Config error" output by searching GitHub Discussions
Guidelines
- prefer the unified
windowruleformat with explicitmatch:prefixes over any legacy alternatives found in syntax-patterns.md - use
snake_caseproperty names and explicit boolean values (on,true/false) - maintain the hybrid strategy: Nix
settingsfor globals/hardware,extraConfigfor verbose or dynamic blocks - always validate headlessly before applying to the active session — config errors in a live session require a restart
Resources
- syntax-patterns.md: Deprecation and modernization mappings.
- validate-hypr-config.sh: Headless validation tool.