mirror of
https://github.com/neoromantique/dotfiles.git
synced 2026-03-13 21:53:20 +03:00
67 lines
3.3 KiB
Markdown
67 lines
3.3 KiB
Markdown
# AGENTS Guide: Dotfiles Repository
|
|
|
|
Chezmoi-managed dotfiles. Source in `~/dotfiles/`, deployed via `chezmoi apply`.
|
|
|
|
## Device Profiles
|
|
|
|
| Profile | Hostname | Primary Monitor | Touchpad | Battery |
|
|
|---------|----------|-----------------|----------|---------|
|
|
| desktop | box | DP-2 | No | No |
|
|
| laptop | bluefin | eDP-1 | Yes | Yes |
|
|
|
|
## Template Variables
|
|
|
|
`{{ .deviceProfile }}` (desktop/laptop), `{{ .hostname }}`, `{{ .primaryMonitor }}`, `{{ .hasTouchpad }}`, `{{ .hasBattery }}`, `{{ .idleTimeout }}` (300/180), `{{ .secretsPath }}` (~/secrets)
|
|
|
|
## File Naming
|
|
|
|
- `private_dot_*` — hidden, 700 perms
|
|
- `dot_*` — hidden, 755 perms
|
|
- `executable_*` — 755
|
|
- `*.tmpl` — Go template
|
|
|
|
## Structure
|
|
|
|
```
|
|
home/
|
|
├── private_dot_config/ # hypr/, fish/, waybar/, ghostty/, quickshell/
|
|
├── dot_local/bin/ # scripts
|
|
└── .chezmoiscripts/ # one-time setup
|
|
```
|
|
|
|
## Hyprland (`home/private_dot_config/hypr/`)
|
|
|
|
`hyprland.conf.tmpl` (main/keybinds/rules), `monitors.conf.tmpl`, `autostart.conf.tmpl`, `colors.conf`, `workspaces.conf`, `hyprpaper.conf.tmpl`, `hypridle.conf.tmpl`, `hyprlock.conf`
|
|
|
|
## Standards
|
|
|
|
- Scripts: `#!/usr/bin/env bash` + `set -euo pipefail`
|
|
- Secrets via `{{ .secretsPath }}`
|
|
- Use `windowrulev2` (not `windowrule`)
|
|
- Use `{{-` to trim whitespace in templates
|
|
|
|
## QuickShell (`home/private_dot_config/quickshell/shell.qml.tmpl`)
|
|
|
|
Single-file bottom bar + popups. VPN scripts in `dot_local/bin/executable_vpn-{status,switcher,helper}`.
|
|
|
|
### Design Language
|
|
|
|
- **Theme**: dark, minimal, no rounded corners (`radius: 0` on modules)
|
|
- **Colors**: bg `#0f0f0f`, module bg `#1a1a1a`, fg `#e0e0e0`, dim `#888888`, accent `#e67e22`, ok `#2ecc71`, warn `#f1c40f`, crit `#e74c3c`, border `#333333`
|
|
- **Font**: `"Terminus, IBM Plex Mono, JetBrainsMono Nerd Font, monospace"` at 12px (11px for section headers)
|
|
- **Text-only indicators** — no icons. Prefixed labels: `VOL 85%`, `MIC muted`, `NET eth 10.0.0.5`, `CPU 12%`, `MEM 34%`, `BAT 72%`, `BRT 50%`, `TIME 2025-01-15 14:30`
|
|
- **Bar**: bottom-anchored, 34px total height, 4px outer margin, 6px inner row padding
|
|
- **Modules**: `ModuleBox` component — `#1a1a1a` bg, 1px border, 22px height, content padded 12px wide
|
|
- **Layout**: left group (workspaces) + flexible spacer + right group (vpn, vol, mic, net, [bat, brt on laptop], cpu, mem, clock, tray), 6px spacing between modules
|
|
- **Popups**: item rows 24px, hover `#2a2a2a`, `●` active / `○` inactive, section headers `━━ Title ━━` in dim color
|
|
|
|
### QuickShell Patterns
|
|
|
|
- **Popups**: fullscreen transparent overlay `PanelWindow` (all anchors true, `ExclusionMode.Ignore`), NOT a second positioned PanelWindow. Three mouse layers: background dismiss, absorb on popup rect, content Column `z: 1`
|
|
- **Cross-window positioning**: `mapToItem(null, 0, 0)` only maps within own window. Compute popup X from layout math against `rightGroup.implicitWidth`
|
|
- **Process sync**: pending counter, decrement in each `onStreamFinished`, combine at 0
|
|
- **Bash safety**: `command -v foo &>/dev/null && foo || echo '{}'`. Use `---TAG---` separators for JS parsing
|
|
- **QML reactivity**: assign NEW object (`Object.assign({}, old, changes)`) to trigger bindings
|
|
- **Keyboard input in popups**: set `focusable: true` on the PanelWindow
|
|
- **PulseAudio**: `pactl list sinks` (not `short`) for descriptions; filter sources with `grep -v '\.monitor'`
|