commit b51f070434275831d9d8b96a984bce6619b4cbdf
Author: lvwmwm <lvwmwm@users.noreply.github.com>
Date:   Fri Aug 28 13:19:27 2026 -0300

    init: canvas branch for color tracking (raw/semantic)

diff --git a/README.md b/README.md
new file mode 100644
index 00000000000..db3a8cce20b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# decord — canvas branch
+
+Forked from [`nexpid/Themelings`](https://github.com/nexpid/Themelings).
+
+Auto-generated by `main`'s `update (hourly)` workflow (`src/update/tasks/colors.ts`). Do not edit manually.
+
+## Contents
+
+- `raw.json` — Discord's raw colors (`tokens/colors/generated/raw-color-definitions.tsx`)
+- `semantic.json` — Semantic colors (full, with `raw` + `opacity` per theme)
+- `semantic_simple.json` — Simplified semantic (`{semantic: {theme: hex}}`)
+- `version.txt`
+
+## `raw` / `semantic` for themers
+
+- `raw.json`: `{ "BLACK_100": "#...", ... }` ~200 keys
+- `semantic.json`: `{ "BACKGROUND_PRIMARY": { "dark": ["#...", {raw:"BLACK_500", opacity:1}], "light": [...] }, ... }`
+- `semantic_simple.json`: `{ "BACKGROUND_PRIMARY": { "dark": "#...", "light": "#..." } }`
+
+Use `semantic_simple.json` for quick theming, `semantic.json` + `raw.json` to resolve `raw` references.
+
+## Links
+
+- Main: https://github.com/lvwmwm/decord
+- Data (code): https://github.com/lvwmwm/decord/tree/data
+- Workflow: `.github/workflows/update.yml`