aboutsummaryrefslogtreecommitdiff
path: root/scripts/theme-studio/README.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-06-08 16:16:02 -0500
committerCraig Jennings <c@cjennings.net>2026-06-08 18:42:38 -0500
commitc96a24d9681cb80682d031ed7a8817d8e80eafa7 (patch)
tree791925831e4e32883ffa7f177d7f9d72a3a2f20e /scripts/theme-studio/README.md
parentc63050d518ca55464045c7e4bfa00ac5190ca0e7 (diff)
downloaddotemacs-c96a24d9681cb80682d031ed7a8817d8e80eafa7.tar.gz
dotemacs-c96a24d9681cb80682d031ed7a8817d8e80eafa7.zip
docs(theme-studio): add color-assignment guide
theme-coloring-guide.org is the design philosophy behind the tool, organized from principles out: seven laws, a role-to-treatment seed table, and three tiers (syntax, UI faces, org packages) as that table projected onto Emacs faces. It documents a shade budget per hue family, a functional signal-color convention table (not an emotion table), color-vision rules, and Emacs face specifics, and closes with canonical references. The README points to it, and dupre is the worked example.
Diffstat (limited to 'scripts/theme-studio/README.md')
-rw-r--r--scripts/theme-studio/README.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/scripts/theme-studio/README.md b/scripts/theme-studio/README.md
index 620340396..e9817ab10 100644
--- a/scripts/theme-studio/README.md
+++ b/scripts/theme-studio/README.md
@@ -8,6 +8,10 @@ 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`.
+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).
+
## Run
```bash