WORK-206
Setting up your dashboard 0 entities found · 9/32 branches scanned
ID:WORK-206Status:ready

Refrakt site adopts presets: ["niwaki"]

Wire the refrakt documentation site to use the niwaki preset on top of the neutral default. The result: neutral chrome (so component examples render exactly as a fresh create-refrakt project would), niwaki syntax (so refrakt's voice lives in code blocks — the surface most uniquely refrakt's). Adds a visible "this site uses the niwaki preset" signal so visitors can mentally separate "default refrakt" from "this site's choice."

Priority:mediumComplexity:smallMilestone:v0.14.0Source:SPEC-051
claude/spec-053-tint-authoring-notes View source

Criteria completion

Criteria completion: 0 of 5 (0%) checked; tracking started on May 18, no incremental history yet0%25%50%75%100%May 18Jun 15

Tracking started May 18 — check back for trends.

Branches 2
claude/spec-053-tint-authoring-notes current ready
main doneclaude/v0.14.0-spec-051-presets done
History 1
  1. 8df92a3
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • refrakt.config.json adds "presets": ["@refrakt-md/lumina/presets/niwaki"] under sites.main (or whichever site is current)
  • A visible signal of which preset the site uses exists — author's choice between three options (capture in resolution):
    • A small "Theme: base + niwaki" indicator in the docs sidebar footer
    • A line in the site footer like "This site uses Lumina's neutral default with the niwaki syntax preset"
    • A deliberate mention on the homepage explaining the composition with a link to the preset docs
  • After change: every code block on the site renders with niwaki colours; all other content (callouts, headings, body, surface) renders with neutral default
  • A user clicking through marketing → docs sees no preset change — niwaki applies site-wide
  • cd site && npm run dev boots cleanly; no console warnings; code blocks visibly use the Japanese-garden palette

Approach

This is a one-line config edit plus a signal-component decision.

For the signal: the lightest option is a small text indicator in the footer. The most discoverable option is a homepage mention. Decide based on what feels right when you see the site rendered — capture the choice in the resolution.

Consider deferring the signal to the preset docs pages (WORK-208) — those pages exist specifically to surface the architecture, so a sidebar link "See how this site is composed" from any docs page might be enough on its own. Worth a brief read of how Vercel and Linear signal their own theme choices for reference.

Dependencies

  • WORK-205 — niwaki preset must exist.
  • WORK-200, WORK-201, WORK-202 — neutral default fully populated.

References

  • SPEC-051 — "Site & Scaffold Implications" section explains the dogfooding rationale
  • refrakt.config.json — file being edited