18 lines
1.7 KiB
Markdown
18 lines
1.7 KiB
Markdown
# Agent Instructions for Hyprtron
|
|
|
|
This repository contains configuration files for a Wayland/Hyprland desktop setup.
|
|
|
|
## Workflow & File Structure
|
|
- **Edit repo files only**: Files in `./config/` map to `~/.config/` and `./local/` map to `~/.local/`. Modify files in this repo; never attempt to modify live files directly in the user's home directory.
|
|
- There are no tests, builds, or dev servers. Treat this as a pure dotfiles structure.
|
|
|
|
## Hyprland Architecture & Launching
|
|
- **Daemon startup via UWSM**: Background services and daemons (e.g., `waybar`, `hyprpaper`, `hypridle`, `walker`, `swayosd-server`) are launched using `uwsm` (Universal Wayland Session Manager). When adding new startups to `hyprland.conf`, use `exec-once = uwsm app -- <command>` rather than bare `exec-once`.
|
|
- **Keybindings**: Application bindings are in `config/hypr/bindings.conf`. Use `bindd` to include descriptions instead of the standard `bind` (e.g., `bindd = $mainMod, KEY, Description, exec, command`).
|
|
- **External scripts**: The user's `PATH` includes `~/.local/share/omarchy/bin` (configured via `config/uwsm/env`). Commands like `omarchy-launch-webapp` are external to this repository.
|
|
|
|
## Theming Quirks (Crucial)
|
|
- The global CSS theme variables are located at `local/share/hyprtron/theme/style.css`.
|
|
- **Hardcoded duplication**: Currently, most tools **do not** import the shared theme file (only `walker` does). Configs for `swaync`, `swayosd`, `waybar`, `hyprlock.conf`, and `hyprland.conf` hardcode the colors (e.g., background `rgba(26, 27, 38, ...)`, border `#33ccff`).
|
|
- **When changing colors**: You must `grep` and manually update the hardcoded hex/rgba/rgb values across all `.css` and `.conf` files. Do not assume updating `local/share/hyprtron/theme/style.css` is sufficient.
|