Four `--shadow-*` tokens, replacing three `box-shadow` values written by hand at three call sites — 8% at 2px, 12% at 3px, 12% at 8px, which is three answers to a question nobody meant to ask twice.

Two stops from `sm` up: a tight contact shadow where the surface meets the page, and a wide ambient fall-off around it. One stop has to choose between them, and either choice reads as a blurred border.

Mixed from `foreground` rather than black, since the page is warm-neutral and a black shadow greys toward a different hue than the borders it runs into.

Declared under Tailwind's `--shadow-*` namespace, so the two `shadow-md` utility sites in the toolbar and the slash menu pick the scale up without being touched.

`--shadow-*: initial` comes first. `@theme` merges with Tailwind's theme rather than replacing it, so a rung we do not declare goes on resolving to a different design system's — `shadow-xl` hardcodes `#0000001a`, pure black, with no reference to the theme at all. Deleting the namespace first means reaching for a rung we do not own draws nothing rather than something plausible. That syntax needs malva 0.16 to parse, hence the dprint plugin bump.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---

### Stack

Merge bottom-up. Each PR targets the one below it, so every diff reads in isolation; GitHub retargets the child automatically as each parent merges.

1. #9  — Emit all theme tokens, fix callout colours, load Inter  ←  `main` 2. #10 — Add two-stop shadow scale tokens 3. #11 — Add radius tokens and replace bare rounded classes 4. #12 — Add type scale tokens, replace arbitrary font sizes 5. #13 — Add easing and duration tokens, set transition defaults 6. #15 — Add one focus-visible outline rule for all controls 7. #16 — Scale buttons down on press 8. #17 — Add tabular-nums to figures and balance plan headings 9. #18 — Shorten empty states and composer status copy 10. #19 — Add entrance animation for newly arrived items

Plan: `docs/superpowers/plans/2026-08-04-design-token-foundation.md`