aboutsummaryrefslogtreecommitdiff
path: root/scripts/theme-studio/README.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-07-02 13:10:54 -0400
committerCraig Jennings <c@cjennings.net>2026-07-02 13:10:54 -0400
commit67a609dd5e98df4df9a3fb40104817e0c25e5582 (patch)
tree636b75b2e874b286e6e97db2f85f4bf1ea0fcd8b /scripts/theme-studio/README.md
parentc3e183da48cc6c807b301a25c91fc0eaaec89a14 (diff)
downloaddotemacs-67a609dd5e98df4df9a3fb40104817e0c25e5582.tar.gz
dotemacs-67a609dd5e98df4df9a3fb40104817e0c25e5582.zip
feat(theme-studio): screenshot harness + ecosystem coverage policy
Two speedrun-enabling pieces. A #preview=<app>&theme=<json> hash handler plus screenshot-previews.sh shoot any app's face table and live preview headlessly under a real theme (WIP.json by default), so preview work can be verified without a human clicking through the studio. The README gains the coverage policy: the studio themes popular packages even when uninstalled, pinning their faces rather than dropping them, and unloaded packages' previews matter more, not less.
Diffstat (limited to 'scripts/theme-studio/README.md')
-rw-r--r--scripts/theme-studio/README.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/scripts/theme-studio/README.md b/scripts/theme-studio/README.md
index df3d9260..da9c7823 100644
--- a/scripts/theme-studio/README.md
+++ b/scripts/theme-studio/README.md
@@ -8,6 +8,17 @@ Reassign colors against the palette, judge legibility with live WCAG-contrast
readouts, then export a `theme.json` that a build step turns into
`themes/<name>-*.el`.
+## Coverage policy
+
+The studio themes popular packages, not just installed ones. The goal is
+generic themes that cover the wider ecosystem, so a package's face
+definitions stay in the studio even when the package is removed from this
+config (ghostel and all-the-icons are the standing examples). Never drop an
+app because its package is uninstalled; pin its face list instead so it
+survives inventory regeneration. Unloaded packages get marked as such in the
+UI, and their live previews matter *more* than the loaded ones' — the studio
+preview is the only place their theming can be seen at all.
+
For the color-assignment philosophy behind the tool — how to group syntax roles,
what to share, where to spend chroma and bold — see
[`theme-coloring-guide.org`](theme-coloring-guide.org).