WORK-210
ID:WORK-210Status:done

v0.14.0 migration note for palette and fonts

Write the v0.14.0 migration guide entry for SPEC-051's palette and typography changes. Existing sites that depended on Lumina's cream-and-navy appearance will see neutral default after upgrading; the one-line opt-in (presets: ["@refrakt-md/lumina/presets/tideline"]) restores the colour appearance. Tideline also brings Plex Sans typography by default, replacing the previous Outfit — a font pin is available for users who want Outfit specifically.

Priority:lowComplexity:smallMilestone:v0.14.0Source:SPEC-051
claude/v0.14.0-spec-051-docs View source

Criteria completion

Criteria completion: 6 of 6 (100%) 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/v0.14.0-spec-051-docs current done
main doneclaude/spec-053-tint-authoring-notes ready
History 1
  1. bfc9111
    Created (done)by bjornolofandersson

Acceptance Criteria

  • A "Palette and typography" section exists in the v0.14.0 migration guide (same destination page as WORK-199 — coordinate locations during implementation)
  • The section opens with the user-facing change: "Lumina ships with a new neutral default palette in v0.14.0. The previous cream-and-navy palette is preserved as the tideline preset."
  • The one-line config snippet for restoring the old colour appearance is shown verbatim
  • The font change is documented: tideline switches font.sans to IBM Plex Sans (from Outfit). The escape hatch for pinning Outfit is shown:
    {
      "theme": {
        "presets": ["@refrakt-md/lumina/presets/tideline"],
        "tokens": {
          "font": { "sans": "'Outfit', system-ui, sans-serif" }
        }
      }
    }
    
  • A note explaining the rationale (one or two sentences linking to SPEC-051 for the full story)
  • Cross-references to WORK-199 (tint shape migration) — both pieces are part of the same v0.14.0 upgrade story

Approach

Single docs PR. The destination page is whatever the v0.14.0 migration guide lives in — coordinate with WORK-199 so they end up in the same place.

The voice is matter-of-fact, not alarmed — most users won't notice the default change because they haven't been hand-customising Lumina anyway. For the small set of users who have hand-tuned around the cream palette, the one-line opt-in restores everything.

Dependencies

  • WORK-200, WORK-204, WORK-203 — the changes being documented must be merged and shipping.

References

  • SPEC-051 — full rationale and the implementation step explicitly calling for this migration note
  • WORK-199 — sibling migration note for tint shape changes