← Commit history
SKILL.md+9−9@@ -5,13 +5,13 @@ description: THE Adom application theme system, the canonical spec every Adom de # The Adom Theme System -One theme system for every Adom desktop surface. Hydrogen Desktop (HD) is the REFERENCE+One theme system for every Adom desktop surface. Adom Hydrogen (ah) is the REFERENCE IMPLEMENTATION; this skill is the contract for implementing the same system elsewhere,-starting with Adom Desktop (AD). The design was measured into place on 2026-07-25 (contrast+starting with Adom Bridge (ab). The design was measured into place on 2026-07-25 (contrast maths, live pixel sampling, in-workbench font probes), so treat the numbers here as decisions, not suggestions. -Source of truth files (HD repo, hydrogen-desktop - PRIVATE):+Source of truth files (Hydrogen repo, hydrogen-desktop - PRIVATE): - `src/routes/styles.css` - the token set and all five scheme blocks - `tools/gen-vscode-themes.mjs` - generates the VS Code theme pack FROM the tokens (pack v7.2.0) - `scripts/check-scheme-parity.sh` + `scripts/check-installed-themes.sh` - the guards@@ -117,10 +117,10 @@ every surface. History that bites: on 2026-07-25 the slug `studio` CHANGED MEANING (it was the dark base, it is now the flagship). Any store that ever held old values must translate them ONCE under old semantics, guarded by a version marker, because the string alone cannot say which era-wrote it. HD's pattern: a NEW localStorage key (`hd-color-scheme2`) whose legacy-key read+wrote it. Hydrogen's pattern: a NEW localStorage key (`hd-color-scheme2`) whose legacy-key read translates {studio->studio-dark, studio-bright-inverse->studio, inverse->studio, blueprint->slate, contrast->studio-bright, graphite->slate} then deletes the legacy key;-plus `desktop.scheme_slug_version = 2` on the saved-preference layer. If AD stores scheme+plus `desktop.scheme_slug_version = 2` on the saved-preference layer. If Adom Bridge stores scheme state, implement the same translation once, and NEVER reuse a slug again without bumping the version and extending the map. @@ -143,7 +143,7 @@ Per-scheme pairing (FONTS_FOR_SCHEME): | slate | `'Cascadia Code', Consolas, 'JetBrains Mono', ui-monospace, monospace` | Satoshi stack | Delivery, learned the hard way:-- Webfonts must be served from YOUR OWN origin with ABSOLUTE paths. HD's relative+- Webfonts must be served from YOUR OWN origin with ABSOLUTE paths. Hydrogen's relative `./adom-fonts/...` URLs 404'd for weeks while a Windows-installed copy silently covered for them; nothing anywhere admitted it. - Isolated webviews (the Claude chat panel) do NOT inherit your page's webfonts. Their brand@@ -156,7 +156,7 @@ Delivery, learned the hard way: ## 6. The VS Code theme contract -The editor themes are GENERATED from the tokens (HD `tools/gen-vscode-themes.mjs`), one+The editor themes are GENERATED from the tokens (Hydrogen `tools/gen-vscode-themes.mjs`), one theme per scheme, labels identical to the picker labels. Rules: - An unknown `workbench.colorTheme` name silently falls back to VS Code's DEFAULT LIGHT theme. Renames must therefore update the installed pack AND the live setting in one step,@@ -205,7 +205,7 @@ Uninstall through the CLI too, so the registration goes with the folder. 1. Define the tokens as CSS custom properties on `:root` (the studio-dark values) plus one `[data-scheme='<slug>']` block per scheme copied from the table above. Adom Studio's block should contain ONLY Bright's text ramp plus the bg/surface swap.-2. Route every colour through the tokens. No hardcoded hex: HD carried 4,641 hardcoded+2. Route every colour through the tokens. No hardcoded hex: Hydrogen carried 4,641 hardcoded values before the sweep and that is why its panels never matched each other. 3. Picker UI: show the LABELS, store the SLUGS, default `studio`, apply via the data attribute before first paint (read the cache directly, do not wait for stores).@@ -219,5 +219,5 @@ Uninstall through the CLI too, so the registration goes with the folder. ## Version -Spec v1.0.0, extracted from hydrogen-desktop @ 2026-07-26 (pack v7.1.0). When HD's tokens+Spec v1.0.0, extracted from hydrogen-desktop @ 2026-07-26 (pack v7.1.0). When Hydrogen's tokens change, regenerate section 2 from styles.css rather than editing it by hand.
package.json+1−1@@ -1,7 +1,7 @@ { "slug": "adom-theme", "name": "adom-theme",- "version": "2.3.6",+ "version": "2.3.7", "type": "skill", "description": "THE Adom application theme: five colour schemes with exact tokens, slugs vs labels, font pairings, the VS Code theme pack (adom.adom-theme, version-locked to this package), migration rules, and the guards. Hydrogen Desktop is the reference implementation.", "discovery_triggers": [
page.json+5−2@@ -52,7 +52,7 @@ "path": "screenshots/hero-v6.png" }, "name": "adom-theme",- "version": "2.3.6",+ "version": "2.3.7", "description": "THE Adom application theme: five colour schemes with exact tokens, slugs vs labels, font pairings, the VS Code theme pack (adom.adom-theme, version-locked to this package), migration rules, and the guards. Hydrogen Desktop is the reference implementation.", "discovery_pitch": "Implementing or matching Adom's look in any app: load this first. Exact tokens for all five schemes, the slug/label contract, font pairings and delivery traps, and the guard scripts.", "files": [@@ -83,7 +83,10 @@ "reference/install-brand-fonts.sh", "reference/check-scheme-parity.sh", "reference/check-installed-themes.sh",- "reference/check-vscode-theme-names.sh"+ "reference/check-vscode-theme-names.sh",+ "reference/gen-adom-studio-v2.mjs",+ "reference/reference-2026-dark.json",+ "readme.html" ], "scripts": { "install": "./install.sh",