← Commit history

Publish 2.3.7

Kyle Bergstedt ·67a9641038 · ·parent b1d8fa9
3 files changed +15−12
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",