Farb-Tokens in CSS und Tailwind ordnen

· 3 Min. Lesezeit

Wie du Farbvariablen nach Rollen benennst und ordnest, Hell- und Dunkelmodus in CSS verbindest und dieselben Tokens in einem Tailwind-v4-Theme nutzt.

Fest eingetragene HEX-Werte, die über ein ganzes Stylesheet verstreut sind, sind der Hauptgrund, warum Farbänderungen wehtun. Ein Rebranding, ein neuer Dunkelmodus oder die Korrektur eines Kontrastproblems wird zum Suchen-und-Ersetzen über Hunderte Zeilen. Farb-Tokens – benannte Variablen, die beschreiben, wofür eine Farbe da ist – lösen das. Dieser Ratgeber zeigt, wie du sie in reinem CSS aufbaust und dieselben Tokens in Tailwind nutzt.

Zwei Ebenen: Basiswerte und Rollen

Ein robustes Setup trennt, was die Farben sind, davon, wie sie eingesetzt werden.

Basis-Tokens (Primitives) sind die rohe Palette, benannt nach Farbton und Stufe. Sie tauchen nie direkt in den Styles von Komponenten auf.

:root {
  --blue-100: #E3E8FF;
  --blue-500: #3D5AFE;
  --blue-700: #2638C4;
  --sand-50:  #F7F5F0;
  --ink-900:  #1D2433;
}

Semantische Tokens (Rollen-Tokens) beschreiben eine Aufgabe in der Oberfläche und verweisen auf einen Basiswert oder haben einen eigenen Wert. Komponenten nutzen ausschließlich diese.

:root {
  --color-bg:         var(--sand-50);
  --color-surface:    #EFECE4;
  --color-border:     #DAD6CC;
  --color-text:       var(--ink-900);
  --color-muted:      #5C6475;
  --color-primary:    var(--blue-500);
  --color-on-primary: #FFFFFF;
  --color-accent:     #C2410C;
}
.button {
  background: var(--color-primary);
  color: var(--color-on-primary);
}

.card {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  color: var(--color-text);
}

Jetzt weiß der Button nicht mehr, dass er blau ist. Wechselt die Marke zu Grün, änderst du eine Zeile. Fällt eine Kontrastprüfung durch, passt du ein Token an, und alle Komponenten ziehen mit.

Tokens nach Rolle benennen, nicht nach Aussehen

Namen wie --light-gray oder --brand-blue beschreiben, wie eine Farbe heute aussieht. Sie werden falsch, sobald sich der Wert ändert – und im Dunkelmodus würde --light-gray eine dunkle Farbe enthalten. Rollennamen bleiben richtig:

  • --color-bg, --color-surface, --color-border für die Struktur.
  • --color-text und --color-muted für Inhalte.
  • --color-primary, --color-accent für Betonung.
  • --color-on-primary, --color-on-accent für Text auf gefüllten Farben.
  • Optionale Statusrollen: --color-success, --color-warning, --color-danger.

Halte die Liste kurz. Ein Dutzend Rollen-Tokens deckt die meisten Produkte ab; ein eigenes Token für jede Komponente bringt das ursprüngliche Problem zurück.

Dunkelmodus wird zu einem Satz neuer Werte

Mit Rollen-Tokens ist der Dunkelmodus kein zweites Stylesheet, sondern dieselben Namen mit anderen Werten. Das Muster unten folgt der Systemeinstellung und lässt trotzdem zu, dass ein Schalter mit einem data-theme-Attribut eines der beiden Themes erzwingt:

@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --color-bg:         #14161F;
    --color-surface:    #1C1F2B;
    --color-border:     #2C3040;
    --color-text:       #E6E8EF;
    --color-muted:      #9AA1B2;
    --color-primary:    #8C9EFF;
    --color-on-primary: #14161F;
    --color-accent:     #FB923C;
  }
}

:root[data-theme="dark"] {
  /* dieselben Werte für alle, die Dunkel von Hand wählen */
}

Beachte, dass die dunkle Primärfarbe ein helleres Blau ist und ihre Beschriftung dunkel. Dunkle Werte sollten ausgewählt und nicht durch Invertieren berechnet werden – warum, erklärt der Ratgeber zum Dunkelmodus.

Moderne Browser unterstützen außerdem die Funktion light-dark(), die beide Werte in einer Zeile hält. Sie folgt der Eigenschaft color-scheme und braucht deshalb diese Deklaration, um zu funktionieren:

:root {
  color-scheme: light dark;
  --color-bg:   light-dark(#F7F5F0, #14161F);
  --color-text: light-dark(#1D2433, #E6E8EF);
}

Die leisen Farben ableiten

Flächen und Rahmen kannst du aus Hintergrund und Text mischen, statt sie von Hand auszuwählen. color-mix() erledigt das in CSS, und das Mischen in OKLCH ergibt gleichmäßige, natürliche Stufen:

:root {
  --color-surface: color-mix(in oklch, var(--color-bg) 94%, var(--color-text));
  --color-border:  color-mix(in oklch, var(--color-bg) 82%, var(--color-text));
}

Weil sie auf andere Tokens verweisen, passen sie sich im Dunkelmodus automatisch an. Prüfe den Rahmen auf 3:1, wenn er ein Eingabefeld oder ein anderes Bedienelement markiert.

Die Tokens in Tailwind CSS v4 nutzen

Tailwind v4 wird in CSS konfiguriert. Jede --color-*-Variable, die in @theme deklariert ist, wird zu einem vollständigen Satz Utilities (bg-*, text-*, border-* und so weiter). Die erzeugten Utilities lesen die Variable zur Laufzeit – aus bg-primary wird background-color: var(--color-primary) –, es reicht also, die Variable für den Dunkelmodus zu überschreiben:

@import "tailwindcss";

/* helle Werte werden zu Utilities: bg-bg, text-text, bg-primary ... */
@theme {
  --color-bg:         #F7F5F0;
  --color-surface:    #EFECE4;
  --color-text:       #1D2433;
  --color-muted:      #5C6475;
  --color-primary:    #3D5AFE;
  --color-on-primary: #FFFFFF;
  --color-accent:     #C2410C;
}

/* dunkle Werte überschreiben dieselben Variablen */
@media (prefers-color-scheme: dark) {
  :root {
    --color-bg:         #14161F;
    --color-text:       #E6E8EF;
    --color-primary:    #8C9EFF;
    --color-on-primary: #14161F;
    /* ... */
  }
}
<button class="bg-primary text-on-primary">Save</button>
<p class="text-muted">Last edited 2 hours ago</p>

dark:-Varianten an jedem Element brauchst du nicht: Die Tokens schalten bereits um, bg-primary ist also in beiden Themes richtig.

Tailwind v3

In v3 bildest du dieselben Variablen in der Konfigurationsdatei ab:

// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        bg: 'var(--color-bg)',
        surface: 'var(--color-surface)',
        text: 'var(--color-text)',
        primary: 'var(--color-primary)',
        accent: 'var(--color-accent)',
      },
    },
  },
}

Werte in OKLCH schreiben

HEX eignet sich gut zum Speichern von Farben, aber beim Bearbeiten lässt sich mit OKLCH leichter denken. Seine drei Kanäle sind Helligkeit, Chroma (Sättigung) und Farbton, und die Helligkeit entspricht recht genau dem, was das Auge sieht. Für eine dunklere Version einer Markenfarbe als Textfarbe senkst du L und lässt den Rest, wie er ist: Aus oklch(55% 0.2 265) wirdoklch(42% 0.2 265). Alle aktuellen großen Browser unterstützen oklch().

Spar dir das Tippen

Jede Palette auf Colorset exportiert genau diese Struktur: Rollen-Tokens für Hell- und Dunkelmodus als CSS-Variablen, ein Tailwind-v4-Theme, eine Tailwind-v3-Config, SCSS, JSON oder Design-Tokens, in HEX, RGB, HSL oder OKLCH. Wähle ein Farbschema, das dir gefällt, öffne den Export und füge ein. Der Farbstufen-Generator erzeugt aus jeder Farbe eine Basis-Skala von 50 bis 950, wenn du die Basisebene selbst aufbauen willst.