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
commit1877fe57eca7f4acc643d9b90e248f7fd67fec33 (patch)
treeab2739a9975144f7f120b1ea6b7ec0a9e64e0c93 /scripts/theme-studio/README.md
parentfba717f4f9be54e6164594aee077f0bda3063746 (diff)
downloaddotemacs-1877fe57eca7f4acc643d9b90e248f7fd67fec33.tar.gz
dotemacs-1877fe57eca7f4acc643d9b90e248f7fd67fec33.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 62034039..e9817ab1 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