Refrakt site adopts the tint cascade

Update the refrakt site's layout files so the cascade actually does something visible: root locked to dark; docs/, runes/, and plan/docs/ explicitly unlocked and set to auto. The site becomes a live demo of the SPEC-052 cascade pattern.

Note: /plan/* on the site is marketing for refrakt's planning system (the @refrakt-md/plan plugin and CLI), so it correctly inherits the root's locked-dark default. Only /plan/docs/* (the plan system's documentation) flips to auto. The repo-root plan/ directory is dev-only and isn't rendered on the site at all — no concern there.

claude/spec-053-tint-authoring-notes View source

Criteria completion

Tracking started May 18 — check back for trends.

Relationships

ID:SPEC-052Status:draft

Per-page and per-subtree tint cascade

ID:WORK-211Status:done

Add theme toggle to Lumina

Priority:highComplexity:mediumMilestone:v0.14.0

ID:WORK-212Status:done

Cascade resolution function in @refrakt-md/content

Priority:highComplexity:mediumMilestone:v0.14.0

ID:WORK-213Status:done

Frontmatter schema extension (tint, tint-mode, tint-lock)

Priority:highComplexity:smallMilestone:v0.14.0

ID:WORK-214Status:done

Renderer integration + pre-paint script

Priority:highComplexity:mediumMilestone:v0.14.0

ID:v0.14.0Status:complete

v0.14.0 — Design tokens contract + brand identity

ID:WORK-216Status:done

/docs/themes/tint-cascade documentation page

Priority:lowComplexity:smallMilestone:v0.14.0

claude/spec-053-tint-authoring-notes current ready

main done chore/v0.14.0-milestone-closeout done claude/v0.14.0-spec-052-site-adoption in-progress

May 18, 08:25 AM5db8451
Content editedby bjornolofandersson
May 18, 08:15 AM8df92a3
Created (ready)by bjornolofandersson

Acceptance Criteria

site/content/_layout.md adds:
```
tint-mode: dark
tint-lock: true
```
site/content/docs/_layout.md adds:
```
tint-mode: auto
tint-lock: false
```
site/content/runes/_layout.md adds the same tint-mode: auto, tint-lock: false
site/content/plan/docs/_layout.md adds the same tint-mode: auto, tint-lock: false
site/content/plan/_layout.md (if it exists) does not unlock — /plan/* is plan-system marketing and correctly inherits the root's dark-locked default
After the change, navigating the site shows:
- Marketing pages (/, /about, /blog/*, /plan/*) render in dark, regardless of system preference
- Theme toggle hidden on marketing pages (per the locked contract)
- Docs pages (/docs/*, /runes/*, /plan/docs/*) respect saved user preference; toggle visible
- Navigating from a docs page (light, by user choice) to a marketing page → marketing renders dark; toggle hides
- Navigating back to a docs page → light returns; toggle reappears
Visual regression / SSR snapshot for at least one page in each subtree confirms no flash of incorrect theme

Approach

This is a small content edit (frontmatter updates on four layout files) that puts the whole SPEC-052 machinery on stage.

The /plan/* routes are marketing pages for refrakt's planning system (the @refrakt-md/plan plugin and CLI), not the repo-root plan/ directory — that's dev-only and never rendered on the site. So /plan/* correctly inherits the root's dark-locked default with no special handling needed; only /plan/docs/_layout.md flips to auto.

Manual smoke test pass after deploying to dev server: click through every section of the site, confirm the toggle visibility flips at the expected boundaries, confirm no FOIT.

Dependencies

WORK-211 — theme toggle exists and honours data-tint-lock.
WORK-212, WORK-213, WORK-214 — cascade machinery shipping.

References

SPEC-052 — "Refrakt Site Adoption" section with the configuration table
Layout files: site/content/_layout.md, site/content/docs/_layout.md, site/content/runes/_layout.md, site/content/plan/docs/_layout.md