Skip to content

style([DST-878]): Polish design tokens and add token documentation#5247

Merged
sebald merged 103 commits intobeta-releasefrom
polish-tokens
Apr 10, 2026
Merged

style([DST-878]): Polish design tokens and add token documentation#5247
sebald merged 103 commits intobeta-releasefrom
polish-tokens

Conversation

@sarahgm
Copy link
Copy Markdown
Member

@sarahgm sarahgm commented Mar 30, 2026

Description

DST-878: Complete design token polish and documentation for the RUI theme.

New color palette:

  • Replace default gray scale with warm neutral "charcoal" palette (oklch, hue 54, 11 steps from 50-950)

Token renames and restructuring:

  • Rename brand to primary, muted-foreground to secondary, focus to focus-highlight
  • Rename status token structure from *-muted/*-muted-foreground/*-muted-accent to */*-foreground/*-accent
  • Add disabled-surface token for disabled control backgrounds
  • Add overlay-backdrop token for modal/tray backdrops
  • Update page background colors

New hover utilities:

  • Add ui-state-hover utility (solid hover for list items, table rows, menu items)
  • Add ui-state-hover-ghost utility (translucent hover for ghost buttons, tabs, action bar)
  • Migrate all components from raw hover:bg-hover/hover:bg-current/10 to the new utilities

Documentation:

  • Add new Token Overview page with complete token reference, annotated UI diagram, color palette demo
  • Add Do/Don't guidance for token misuse, hover and selection pattern docs
  • Document disabled-surface naming rationale and input vs surface-border distinction
  • Add "Proposing changes" section for token change requests
  • Remove outdated design-tokens.mdx and design-token-guidelines.mdx pages
  • Update all cross-references to point to new token overview

Test Instructions:

  1. pnpm build:themes -- theme builds without errors
  2. pnpm typecheck:only -- no type errors
  3. pnpm start -- Token Overview page renders at /foundations/token-overview
  4. Verify color palette demo shows charcoal scale horizontally
  5. Verify annotated UI diagram renders with correct token callouts
  6. Verify Do/Don't sections render correctly
  7. Verify old pages (/foundations/design-tokens, /getting-started/design-token-guidelines) return 404
  8. Check hover behavior in Storybook (pnpm sb) for Button, Tabs, ListBox, Table, Sidebar

Reviewers:

@marigold-ui/developer

Pull Request Checklist:

  • Marigold docs and Storybook Preview is available
  • Added/updated unit tests and storybook for this change (for new code or code which already has tests).
  • Added/Updated documentation (if it already exists for this component).
  • Updated visual regression tests (only necessary when ui changes in the PR)

🤖 Generated with Claude Code

sarahgm and others added 2 commits April 8, 2026 16:13
The "repositories" option is global-only and cannot be used in a
repo config file. Use RENOVATE_REPOSITORIES env var instead.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Accessibility tests executed. Download the report here.

@github-actions
Copy link
Copy Markdown
Contributor

Accessibility tests executed. Download the report here.

@jim761
Copy link
Copy Markdown
Contributor

jim761 commented Apr 10, 2026

Tiles.stories still has border-border-brand, muted-foreground also still exists in some files

sarahgm and others added 2 commits April 10, 2026 11:51
Introduces `--color-neutral` (charcoal-300) for inactive form control
backgrounds like the Switch track. Replaces the old `bg-input` token
with `bg-neutral` which better describes the semantic purpose.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

Accessibility tests executed. Download the report here.

Better semantic fit: `control` describes the resting fill of form
controls like the switch track, and aligns with existing control
naming (h-control, spacing-control). Expanded docs section.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

Accessibility tests executed. Download the report here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🚨 Breaking Change type:docs Improvements or additions to documentation type:feature New feature or component type:infrastructure Tooling and other chores

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants