Was macht Design-Tokens?
Ein kleiner Satz benannter Werte, der überall verwendet wird, macht eine Website geplant und nicht zusammengewürfelt. Definiere Tokens vor Komponenten; eine spätere Änderung der Marke bedeutet dann nur noch die Bearbeitung eines Blocks.
Was du angeben solltest
Eine Markenfarbe (oder ein Stimmungswort), einen hellen oder dunklen Hintergrund und den Ton (geschäftlich, verspielt, redaktionell, technisch). Alles andere kann abgeleitet werden.
Farbe
Arbeite mit Rollen, nicht mit Farbnamen, damit ein Rebranding keine Umbenennung erfordert.
| Token | Rolle | Faustregel |
|---|---|---|
--bg | Seitenhintergrund | Gebrochenes Weiß oder nahe Schwarz, niemals reines #fff oder #000 |
--surface | Karten, Eingabefelder | 2 bis 4 % Helligkeitsunterschied zu --bg |
--text | Fließtext | Mindestens 7:1 auf --bg |
--muted | Sekundärtext | Mindestens 4,5:1 auf --bg |
--border | Trennlinien | 10 bis 15 % Textfarbe gemischt in Hintergrundfarbe |
--accent | Buttons, Hervorhebungen | Die Markenfarbe |
--accent-ink | Links und Akzenttext auf --bg | Die Markenfarbe, abgedunkelt (oder aufgehellt auf dunklem Hintergrund), bis sie 4,5:1 erreicht |
--on-accent | Text auf Akzent | Diejenige von Weiß oder Dunkel, die 4,5:1 erreicht |
Richtlinien:
- Töne die Neutralfarben leicht in Richtung des Akzentfarbtons (2 bis 6 % Sättigung). Reine Grautöne neben einem warmen Akzent wirken zusammenhangslos.
- Verwende den Akzent auf ungefähr 10 % der Fläche. Wenn alles akzentuiert ist, ist nichts akzentuiert.
- Ein zweiter Akzent ist selten nötig. Füge einen nur für eine eindeutige Bedeutung hinzu, z. B. Erfolg oder Sonderangebot.
- Für den Dark Mode nicht invertieren. Erhöhe die Helligkeit der Oberfläche mit zunehmender Höhe und reduziere die Akzentsättigung ein wenig, damit es nicht leuchtet.
Wenn die CLI webcraft verfügbar ist, generiere einen Startsatz anstatt die Werte von Hand abzuleiten. Sie wendet alle obigen Regeln an, löst die Helligkeit, bis jedes Paar besteht, und erstellt das dunkle Thema separat:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # auch: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # WordPress theme.json mit denselben Werten
In einem MCP-Client ist dasselbe das Tool generate_tokens. Behandle die Ausgabe als ersten Entwurf: optisch anpassen, dann erneut prüfen.
Überprüfe jedes Text-Hintergrund-Paar vor der Finalisierung:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # Fallback ohne Installation, nur Hex-Werte
Die erste Form gibt das Verhältnis und die WCAG-Stufen für ein Paar aus. Die zweite liest eine CSS-Datei und prüft die Standard-Rollenpaare in jedem Themenblock (:root, [data-theme], prefers-color-scheme), löst var() auf und liest Hex, rgb(), hsl(), oklch() und color-mix(). Fehlschlagende Paare sind der häufigste Barrierefreiheitsfehler auf neuen Websites, und sie sind für Menschen mit gutem Sehvermögen auf einem guten Monitor unsichtbar, weshalb dies ein Skript und keine Entscheidung nach Gefühl ist.
Typografie
- Höchstens zwei Schriftfamilien: eine für Überschriften, eine für Fließtext. Eine einzelne Familie in zwei Strichstärken ist oft besser.
- Paare durch strukturellen Kontrast (Serifen-Auszeichnung mit serifenlosem Fließtext oder kondensierte Auszeichnung mit normalem Fließtext), nicht zwei ähnliche serifenlose Schriften.
- Fließtextgröße 16 bis 18 Pixel, Zeilenhöhe 1,5 bis 1,7, Zeilenlänge 60 bis 75 Zeichen.
- Auszeichnungsschrift: Zeilenhöhe 0,95 bis 1,1, negativer Buchstabenabstand, der mit der Größe zunimmt.
- Fluide Skala mit
clamp(), damit es keine Sprünge zwischen den Breakpoints gibt:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- Lade Schriftarten mit
font-display: swap, lade die ein oder zwei Dateien vor, die oberhalb des Falzes verwendet werden, und subsette sie bei Selbsthosting.
Abstände, Radius, Schatten
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* vertikaler Abstand zwischen Abschnitten */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* seitlicher Seitenabstand */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- Wähle eine Ecken-Persönlichkeit (scharf, weich oder Pille) und halte sie ein. Gemischte Radien sind der schnellste Weg, um inkonsistent zu wirken.
- Der Abstand zwischen Abschnitten sollte deutlich größer sein als der Abstand innerhalb von ihnen; diese Lücke zeigt dem Auge, wo ein Abschnitt endet.
Ausgabe
Liefere eine tokens.css mit einem :root-Block, einem optionalen [data-theme="dark"]-Block und einer kurzen Tabelle, welches Token wo verwendet wird. Gib dann die Kontrastergebnisse für Fließtext, sekundären Text und Button-Text an.
Rebranding einer bestehenden Website
Ordne zuerst vorhandene hartcodierte Werte Rollen zu (durchsuche das CSS nach Hex-Codes und zähle Vorkommen), ersetze sie durch Tokens, überprüfe, ob sich visuell nichts geändert hat, und tausche dann die Token-Werte aus. Beides auf einmal zu tun, macht Regressionen unmöglich nachvollziehbar.