Updates

docs/brand.md

@@ -0,0 +1,48 @@
+# Brand
+
+Jarvis is the product name. Jarvis QVAC is the product line. HoneyPeer, LLC
+holds copyright. Gold is presence; cyan is thought.
+
+## Tokens
+
+Source of truth: `apps/gnome-extension/[email protected]/brand/tokens.json` and
+`apps/gnome-extension/[email protected]/brand.js`.
+
+| Token | Hex | Use |
+| --- | --- | --- |
+| Gold | `#F4B942` | Default accent, talk button, user rows, idle panel name |
+| Gold bright | `#FFE09A` | Talk hover |
+| Signal | `#4FD2FF` | Thinking, Jarvis reply rows, computer-use chrome |
+| Ink | `#0B0E14` | HUD background |
+| Paper | `#F6F7FB` | Primary HUD text |
+
+Accent presets in Settings: Gold, Signal `#4FD2FF`, Copper `#E07A3D`, Jade
+`#3DDC97`, Rose `#F071A8`. A custom `#RRGGBB` value is accepted. Invalid hex
+keeps Gold.
+
+## Assets
+
+All live under `apps/gnome-extension/[email protected]/brand/`:
+
+- `icons/jarvis-mark.svg` — visor-J mark (gold stroke, cyan core)
+- `icons/jarvis-mark-symbolic.svg` — `currentColor` symbolic
+- `icons/jarvis-wordmark.svg` — mark + JARVIS letters
+- `icons/io.qvac.Jarvis.Control.svg` — app icon
+- `gtk.css` — Control Center / preferences CSS
+
+Install copies the app icon to
+`~/.local/share/icons/hicolor/scalable/apps/io.qvac.Jarvis.Control.svg` and
+writes `~/.local/share/applications/io.qvac.Jarvis.Control.desktop`.
+
+## HUD rules
+
+The GNOME Shell stylesheet is St CSS, not GTK4 CSS.
+
+- Do not put `--custom-properties` inside `/* */` comments.
+- Do not declare extra `--var: value` blocks in the stylesheet; `--jarvis-accent`
+  is set from GSettings in JS.
+- Do not use `alpha(var(--jarvis-accent), …)` or `icon-size`.
+- Panel: mark plus **Jarvis** when idle; mark plus a state chip
+  (Listening / Thinking / Speaking / Privacy) when busy. Never both labels.
+- Popup status uses `jarvis-local` only. Do not put `jarvis-state-*` on HUD
+  labels; those classes are for `.jarvis-panel-state`.