docs(theming): document terminal ANSI palette and its deployment targets

Record the CyberQueer 16-colour ANSI palette (with hex values per slot)
and note that it's mirrored identically across kitty, Alacritty, and
Ghostty configs.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
main
Amir Alexander Abdelbaki 2026-07-23 09:06:38 +02:00
parent cd2f1424c7
commit 1faec197a7
1 changed files with 34 additions and 0 deletions

View File

@ -18,6 +18,38 @@ COLOR_RED=F50505 # Red — danger indicators, alerts
---
## Terminal ANSI Palette
The 5 base colours above cover UI accents, but terminals (kitty, Alacritty, Ghostty) also need a full 16-colour ANSI palette. The "CyberQueer" terminal theme extends the base palette with neon green/yellow/magenta/cyan tints kept in the same violet/crimson family, so `ls`, `git`, and syntax highlighting stay legible instead of clashing.
Defined in `desktopenvs/hyprdrive/kitty/themes/cyberqueer.conf` (canonical source) and mirrored into every kitty and Alacritty config in the repo:
| Slot | Name | Normal | Bright |
|------|------|--------|--------|
| 0/8 | black | `#1A1A1A` | `#4B3A55` |
| 1/9 | red | `#E40046` | `#F50505` |
| 2/10 | green | `#33E6A0` | `#5CFFC2` |
| 3/11 | yellow | `#E8B23D` | `#FFD873` |
| 4/12 | blue | `#5018DD` | `#8C6FFF` |
| 5/13 | magenta | `#A6178C` | `#FF5FC0` |
| 6/14 | cyan | `#34C6C6` | `#6FF5F0` |
| 7/15 | white | `#D6ABAB` | `#F2DEDE` |
Plus the fixed UI slots:
| Role | Hex |
|------|-----|
| Foreground | `#D6ABAB` |
| Background | `#1A1A1A` |
| Cursor | `#E40046` |
| Cursor text | `#5018DD` |
| Selection background | `#5018DD` |
| Selection foreground | `#E40046` |
This palette is deployed identically to kitty (`kitty/themes/cyberqueer.conf`, `kitty/current-theme.conf`), Alacritty (`alacritty/alacritty.toml`, `[colors]` tables), and Ghostty (`ghostty/config`) across every desktop environment, so switching terminal emulators doesn't change the colours you see.
---
## Applying the Theme
```bash
@ -57,6 +89,8 @@ On a fresh install where configs have been copied but no state file exists yet,
| `kitty/current-theme.conf` | Terminal colour palette |
| `kitty/kitty.conf` | Terminal background & accents |
| `kitty/themes/cyberqueer.conf` | Kitty colour scheme definition |
| `alacritty/alacritty.toml` | Alacritty terminal colour palette |
| `ghostty/config` | Ghostty terminal colour palette |
| `waybar/style.css` | Top bar widget colours |
| `wofi/style.css` | App launcher colours |
| `walker/themes/cyberqueer.css` | Walker launcher theme |