Problem/Motivation

Design System API proposes a shared design contract for Drupal: semantic design tokens with defaults, which themes fill (directly or through adapters) and modules build against, so contrib UI looks right under any admin or frontend theme. The concept is written up, and a v0 runs on Drupal 12.0.0-beta1: a token vocabulary on core's Design Tokens API, a resolver with per-context values and provenance, adapters for Default Admin and Claro, the Media Library restyled only through the contract, a CSS linter, and a YAML editor for site authors.

Before an alpha we need the people who know each area to check the direction. Each child issue has a short review brief with 3–5 specific questions, what was built, screenshots and how to try it in the demo site.

Proposed resolution

design-system-api-plan

One review issue per area. Suggested reviewers are the maintainers listed for that area in core's MAINTAINERS.txt; nobody has committed to anything. If you'd rather not be listed, or know someone better placed, please say so here.

Issue Area Suggested reviewers Why them
#3627977: [Review] Design Tokens API: value types vs. references, $extensions, vocabulary ownership Design Tokens API and UI Suite pdureau, grimreaper SDC and Asset Library API maintainers; UI Suite
#3627978: [Review] Components and patterns: SDC component tokens, an "implements" relation, custom elements Components and patterns e0ipso, mogtofu33, pdureau, nod_ Single-Directory Components maintainers; JavaScript
#3627979: [Review] Admin theme: the Default Admin adapter and the Media Library pilot Admin theme saschaeggi, jurgenhaas Admin theme maintainers
#3627981: [Review] UX and Navigation: the problem, frontend defaults, page regions, authoring UX and Navigation ckrina, nod_ UX manager, Usability and Navigation maintainers
#3627983: [Review] CSS: --ds-* naming, context blocks, cascade layers, delivery, linting CSS mherchel, JohnAlbin CSS maintainers
#3627984: [Review] Media Library: the pilot's classes, tokens and replaced theme CSS Media Library seanB, phenaproxima Media Library maintainers
#3627986: [Review] Accessibility: must-level rules, high contrast, contrast pairs, testing Accessibility mgifford, bnjmnm, kentr Accessibility maintainers

Related core work: #3531854: Add a Design Tokens & CSS variables API (Design Tokens API), #3622909: Add remaining design tokens value types (remaining DTCG value types: color, border, shadow, …), #3590100: Add support for design tokens aliases (token references), #3624211: Add SDC specific design tokens (SDC component tokens).

Remaining tasks

  • Reviews in the child issues; answers summarized under "What we heard" in each brief.
  • Decisions from the reviews folded into the concept.
  • Core value types in #3622909: Add remaining design tokens value types (color, border, shadow first); then drop the module's interim color and shadow plugins.
  • Decide where adapters for contrib themes live (Claro is contrib on Drupal 12; Gin once it supports Drupal 12).
  • Alpha release once the vocabulary and the review outcomes are settled.

User interface changes

None in core. The module adds Appearance » Design system (author values per theme).

API changes

None in core yet. Candidates for core come out of the reviews (value types, references, $extensions).

CommentFileSizeAuthor
#2 Screenshot 2026-10-03 at 14.59.26.png403.21 KBd34dman

Comments

d34dman created an issue. See original summary.

d34dman’s picture

Issue summary: View changes
StatusFileSize
new403.21 KB
d34dman’s picture

Related issues: +#3517033: Add a Style API