wealth/docs/decisions/0028-landing-only-tokens.md

1.1 KiB

0028 Landing-only tokens in island

Status: Proposed · Area: design · Date: 2026-10-07 · Decided by: agent

Context

The landing's spec has page-only type (h1 28/40 → 34/50 → 46/66, section titles 24/36 → 30/44), a 1184px content width, a black gradient under white text on the hero image, and a 720px step inside bull's range for its wider grids. None had a token, and raw sizes are not allowed where a token can exist.

Decision

  • island theme.css gains --breakpoint-tablet: 720px, --text-hero, --text-hero-md, --text-hero-lg, --text-section, --text-section-lg, --container-page: 74rem and --image-shade.
  • Typography gains hero and section variants, which step up at tablet and desktop.
  • tablet: is for the landing's grids only; navigation and app layout still switch only at desktop (1024px).

Alternatives

  • Arbitrary values (min-[720px]:, text-[28px]): rejected; raw sizes spread and drift.
  • The design system's display and heading-lg instead: rejected; they don't match the spec's sizes.

Consequences

Other marketing pages can reuse the tokens. Using tablet: outside the landing needs a new decision.