WORK-380
ID:WORK-380Status:ready

Surface-model showcase gallery

The v0.20.0 surface model shipped with per-rune reference docs (card cover, recipe cover, bg, surfaces.md) but no single page that shows the vocabulary as a system. Build a dedicated showcase gallery that demonstrates the whole surface model on one page — the "wow" surface a visitor lands on to grasp what the model can do — organised by the model's own axes.

Priority:mediumComplexity:moderateMilestone:v0.20.1Source:SPEC-086
claude/v0.20.1-docs-showcase-plan View source

Criteria completion

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

Tracking started Jun 10 — check back for trends.

Branches 4
History 1
  1. 0499a2b
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • A dedicated gallery page exists under site/content/ demonstrating the surface model across all four axes (chrome, fills, cover, posture), each as a live preview cluster with the authored Markdown shown.
  • The page reads as a curated showcase (magazine rhythm), not an API dump — short framing prose per axis, cross-linked to the surfaces, card, bg, and recipe references for the full attribute tables.
  • Renders correctly in light and dark mode and at mobile widths; no layout/overflow regressions (verify the cover/frost and displaced-frame cells especially).
  • Linked from the docs nav and cross-referenced from runes/surfaces.md.

Approach

Author as standard site content with the preview rune for live results. Reuse the canonical example imagery already used in the references (e.g. the tequila sunrise cover). Keep live sandbox/iframe use out of this page — the surface model is all static rendering, so the gallery stays fast.

References

  • Surface model: SPEC-086, SPEC-087, SPEC-088, SPEC-089, SPEC-090
  • Existing docs: site/content/runes/surfaces.md, runes/card.md, runes/bg.md, runes/learning/recipe.md