From 19fab4a783a1ad51c452f56ca1571ae9cf3b32cd Mon Sep 17 00:00:00 2001 From: Hisham Aburaqibah Date: Sun, 20 Sep 2026 11:14:15 +0200 Subject: [PATCH] Match the shipped styling to the Claude Design drafts An audit of all twelve draft files against the build turned up a set of mismatches, most of them in the tier-2 token layer rather than in any one component. Tier 1 is untouched throughout - only the meanings moved. SHAPE. The drafts draw three corners, not five: 2px for a tag, thumbnail, flag or checkbox, 4px for anything with a box, and fully round for a filter chip or status pill. Nothing in any draft is 8px or 12px. --radius-card and --radius-surface therefore come down to radius/sm, a --radius-chip is added for the 2px tier, and --radius-control-lg - a quirk of the Figma Button frame's ghost cells - is retired along with its four consumers. ELEVATION. A shadow is a fraction of the ground it falls on, and the ramp was tuned for a white page: on the drafts' near-black ground a 12-28% black is invisible. Tier 1 gains the two deep steps the drafts actually draw (--shadow-dark-lg/xl), and --elevation-card/-popover/-modal move into the per-surface blocks so the dark surface can take them while the light one keeps the soft ramp. A resting card now has no shadow at all - the drafts separate with a hairline - and the black is spent on what floats. CARDS. The hover was a white-24% hairline and a faint glow; the drafts turn the hairline accent green, lift the card 6px and land a deep black under it. The lift is pointer-only and is dropped under prefers-reduced-motion. GHOST IS A TEXT LINK. The drafts never fill a ghost control - every "All updates ->" is plain text that turns green while the label-to-arrow gap opens. The tokens carry no fill in any state and the variant opts out of the 3px lift, which also retires the WCAG workaround the old Figma hover forced (green label on a green fill, 1.40:1). NAVIGATION. A nav label rests in text/secondary and brightens to primary; the current section stays primary and is marked by the accent rule, not by green text. HERO STRIPE. The middle block was painted near-black against a comment claiming the redesign had dropped white; the drafts paint it #F8F9FA. Back to background/inverse, and to the drafts' 390 : 495 : 363 split. styles/README.md is updated to match, including a contrast table that still described --surface-raised as the retired #2e2e2c. Not changed, because each is a decision rather than a defect: the drafts set every eyebrow, tag and meta line in IBM Plex Mono at 10-11px with 1.2-1.4px tracking (a third typeface, and no Arabic counterpart); draft headings are weight 800, which needs a font file we do not have; and the EU badge statement stays at --text-primary, since the visibility lockup is contractual. Co-Authored-By: Claude Opus 5 (1M context) --- apps/web/app/components/ui/Button/Button.css | 30 +++++-- apps/web/app/components/ui/Card/CardCTA.tsx | 5 +- .../app/components/ui/Card/CardContent.tsx | 2 +- apps/web/app/components/ui/Card/CardShell.tsx | 10 ++- apps/web/app/components/ui/Card/CardStat.tsx | 2 +- apps/web/app/components/ui/Card/card.css | 21 ++++- apps/web/app/components/ui/Input/Input.css | 2 +- .../components/ui/Navigation/DesktopNav.tsx | 19 +++-- .../app/routes/_events-opportunities/ui.tsx | 2 +- apps/web/app/routes/_page-kit/sections.tsx | 27 +++---- apps/web/app/routes/_shared/listing-ui.tsx | 2 +- .../app/routes/activities-and-initiatives.tsx | 2 +- apps/web/app/routes/events-calendar.tsx | 2 +- apps/web/app/routes/home.tsx | 2 +- apps/web/app/routes/news-and-updates.tsx | 2 +- .../app/routes/resources-and-publications.tsx | 2 +- apps/web/app/styles/README.md | 73 +++++++++++------ apps/web/app/styles/primitives.css | 13 ++++ apps/web/app/styles/semantic.css | 78 ++++++++++++------- 19 files changed, 197 insertions(+), 99 deletions(-) diff --git a/apps/web/app/components/ui/Button/Button.css b/apps/web/app/components/ui/Button/Button.css index 5caa2ad..0a1f4a1 100644 --- a/apps/web/app/components/ui/Button/Button.css +++ b/apps/web/app/components/ui/Button/Button.css @@ -26,6 +26,9 @@ * "Ghost / Large / Default" is the one cell in the matrix with no padding while its own Hover and Disabled cells have it - an authoring slip that would make the button jump on hover. Padding is kept on all ghost states. + * Ghost is repainted to the Claude Design drafts rather than to the Figma + frame: text-only throughout, no hover fill, no lift, widening gap. See + the block below and the ghost tokens in semantic.css. * Disabled uses the opaque `-bg-disabled` / `-fg-disabled` tokens rather than Figma's 40% opacity, so the page never shows through a disabled control. `--control-opacity-disabled` still holds the 0.4 if that is ever wanted. @@ -190,11 +193,28 @@ --sh-btn-border-disabled: var(--interactive-ghost-border-disabled); } - /* Figma gives the ghost md/lg cells radius.md while every other cell uses - radius.sm - reproduced rather than normalised. */ - .sh-btn[data-variant="ghost"][data-size="md"], - .sh-btn[data-variant="ghost"][data-size="lg"] { - border-radius: var(--radius-control-lg); + /* GHOST IS A TEXT LINK, NOT A BUTTON. + The drafts draw "All updates ->" and "What we do ->" as plain text that + turns accent green while the label-to-arrow gap opens from 8px to 12px. + So the ghost variant opts out of the 3px lift the filled controls take - + nothing that has no box should appear to rise off the page - and animates + its gap instead. (The old Figma-quirk override that gave ghost md/lg + radius.md is gone with --radius-control-lg; every control is 4px.) */ + .sh-btn[data-variant="ghost"] .sh-btn__content { + transition: + opacity var(--motion-duration-fast) var(--motion-ease-standard), + gap var(--motion-duration-base) var(--motion-ease-standard); + } + + @media (hover: hover) { + .sh-btn[data-variant="ghost"]:hover:not(:disabled):not([aria-disabled="true"]):not([data-loading]) { + transform: none; + } + + .sh-btn[data-variant="ghost"]:hover:not(:disabled):not([aria-disabled="true"]):not([data-loading]) + .sh-btn__content { + gap: var(--spacing-sm); + } } /* --------------------------------------------------------------------- diff --git a/apps/web/app/components/ui/Card/CardCTA.tsx b/apps/web/app/components/ui/Card/CardCTA.tsx index 07305fd..0ff8ded 100644 --- a/apps/web/app/components/ui/Card/CardCTA.tsx +++ b/apps/web/app/components/ui/Card/CardCTA.tsx @@ -65,7 +65,10 @@ export function CardCTA({ data-surface="dark" className={cx( "sh-card relative flex flex-col gap-lg rounded-surface p-10", - "bg-surface-accent text-text-on-accent shadow-[var(--elevation-popover)]", + /* The drafts rest nothing on a shadow - a panel is a fill and an edge, + and the black is spent on what floats. --elevation-card is that + resting step: none on the dark surface, soft on the light one. */ + "bg-surface-accent text-text-on-accent shadow-[var(--elevation-card)]", "sm:flex-row sm:items-center", className, )} diff --git a/apps/web/app/components/ui/Card/CardContent.tsx b/apps/web/app/components/ui/Card/CardContent.tsx index 2aa88f9..cf12927 100644 --- a/apps/web/app/components/ui/Card/CardContent.tsx +++ b/apps/web/app/components/ui/Card/CardContent.tsx @@ -85,7 +85,7 @@ export function CardContent({ light on both surfaces - text-on-accent is the only always-white role, text-primary would go dark on the light surface. */} {badge ? ( - + {badge} ) : null} diff --git a/apps/web/app/components/ui/Card/CardShell.tsx b/apps/web/app/components/ui/Card/CardShell.tsx index 8b27dd9..1d2b9ab 100644 --- a/apps/web/app/components/ui/Card/CardShell.tsx +++ b/apps/web/app/components/ui/Card/CardShell.tsx @@ -7,7 +7,7 @@ STYLING RULE for this whole directory: * colour and radius come from the tier-2 Tailwind bridge (bg-surface-raised, text-text-accent, border-border-subtle, - rounded-surface, ...) - never a hex, never a tier-1 primitive; + rounded-card, ...) - never a hex, never a tier-1 primitive; * tokens without a bridge utility are spent as arbitrary values, e.g. shadow-[var(--elevation-card)]; * spacing uses the named scale (p-lg = 24, gap-md = 16) so the Figma @@ -143,8 +143,10 @@ export interface CardShellProps { } /** - * The surface every card shares: raised fill, hairline border, 12px corner - * (Figma radius/lg) and the card elevation. + * The surface every card shares: raised fill, hairline border and the 4px + * corner the design drafts draw. `--elevation-card` is the drafts' resting + * shadow, which on the dark surface is none at all - the hairline does the + * separating, and the black is kept for the hover state in card.css. */ export function CardShell({ as = "article", @@ -160,7 +162,7 @@ export function CardShell({ "sh-card", linked && "sh-card--linked", "relative flex bg-[var(--surface-card)] text-text-primary", - "rounded-surface border border-border-subtle shadow-[var(--elevation-card)]", + "rounded-card border border-border-subtle shadow-[var(--elevation-card)]", className, )} > diff --git a/apps/web/app/components/ui/Card/CardStat.tsx b/apps/web/app/components/ui/Card/CardStat.tsx index ee2b6fd..255a6a9 100644 --- a/apps/web/app/components/ui/Card/CardStat.tsx +++ b/apps/web/app/components/ui/Card/CardStat.tsx @@ -72,7 +72,7 @@ export function CardStat({ is falling. */