alexion/dev
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(nix): clarify dotfiles style rules

Browse Source
This commit is contained in:
alexion
2026-10-20 03:55:13 -04:00
parent 8bb4d61fa8
commit 1a214ec22c
1 changed files with 10 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
src/skills/style/nix/rules/dotfiles.md
View File

@@ -1,41 +1,39 @@
## Register desktop window icons
## Register window icons
### Rule
Register each graphical desktop application in `registry.window-icon`.
Match the entry to the window class.
Store the icon as its rendered string.
When adding a graphical application, register its window-class match and rendered icon in `registry.window-icon`.
### Rationale
The Hyprland workspace indicator uses the registry to replace its default glyph.
Hyprland uses this registry to render workspace icons for open application windows.
### Examples
List active window classes with:
Run this command to list window classes from the running compositor:
```bash
hyprctl clients -j | jq -r '.[].class' | sort -u
```
## Separate guest wiring from deployment configuration
## Separate guest wiring from host deployment
### Rule
Keep guest modules host agnostic.
Keep guest modules host-agnostic.
Put host paths, served volumes, guest addresses, and routes in host configuration.
### Rationale
A guest module supports multiple hosts.
Host configuration owns each deployment's infrastructure choices.
Guest modules support multiple hosts.
Host configuration owns deployment-specific infrastructure choices.
## Decrypt guest secrets on the host
### Rule
Set the owner of a host-decrypted guest secret to a host user.
Grant guest services access with a shared group and a read-only guest mount.
Set the owner of a guest secret decrypted by the host to a host user.
Give the guest service group read access through a read-only bind mount.
### Rationale