diff --git a/docs/md/theming.md b/docs/md/theming.md
index a3420d3..4c28277 100644
--- a/docs/md/theming.md
+++ b/docs/md/theming.md
@@ -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 |