Zum Inhalt springen
Dokumentation

Grundlagen

Design-Tokens

Stabil

Flächen, Text, Status und Diagramme als semantische Variablen – mit Werten für hell und dunkel, Dichte, Radius und Schriften.

Die Library hat zwei Farbschichten. Ganz unten stehen die Markenwerte (navy, navy-deep, cloud, line, orange, amber-text, slate) im @theme-Block von styles.css. Darüber liegt die semantische Schicht: Namen, die eine Aufgabe beschreiben, nicht einen Farbton. Komponenten und Produkte verwenden ausschließlich die semantische Schicht; die Rohwerte sind nur für Logo und OpenFrame gedacht.

Die semantischen Tokens stehen als CSS-Variablen in :root (hell) und .dark (dunkel). Über @theme inline werden sie zu Tailwind-Utilities wie bg-background oder text-muted-foreground. Weil die Namen in beiden Themes gleich bleiben, funktionieren Komponenten ohne Sonderfälle.

Farb-Tokens

Die Tabelle liest @neodin-eu/ui/styles.css beim Bauen der Seite und zeigt Wert und Kontrast für beide Themes. Der Kontrast ist das WCAG-Verhältnis: bei -foreground-Tokens gegen ihre Basisfläche, bei den Statustexten gegen --background. Steht nur ein Wert, ist der Kontrast in hell und dunkel gleich.

Semantische Farb-Tokens aus @neodin-eu/ui/styles.css
FarbfeldTokenUtilityHellDunkelKontrast
--pagebg-page#f5f8fc#0a1628—
--backgroundbg-background#ffffff#0f2340—
--foregroundtext-foreground#0f2340#f5f8fc15.7 : 1 / 14.8 : 1
--cardbg-card#ffffff#0f2340—
--card-foregroundtext-card-foreground#0f2340#f5f8fc15.7 : 1 / 14.8 : 1
--popoverbg-popover#ffffff#0f2340—
--popover-foregroundtext-popover-foreground#0f2340#f5f8fc15.7 : 1 / 14.8 : 1
--primarybg-primary#0f2340#f5f8fc—
--primary-foregroundtext-primary-foreground#ffffff#0f234015.7 : 1 / 14.8 : 1
--secondarybg-secondary#e8eef6#1c3557—
--secondary-foregroundtext-secondary-foreground#0f2340#f5f8fc13.5 : 1 / 11.6 : 1
--mutedbg-muted#eef3f9#16294a—
--muted-foregroundtext-muted-foreground#52647e#9db0c85.4 : 1 / 6.5 : 1
--accentbg-accent#e4edf8#1d3a5e—
--accent-foregroundtext-accent-foreground#0f2340#f5f8fc13.3 : 1 / 10.8 : 1
--destructivebg-destructive#b42318#f98080—
--destructive-foregroundtext-destructive-foreground#ffffff#0f23406.6 : 1 / 6.3 : 1
--borderbg-border#d3ddea#26405f—
--inputbg-input#74869c#5a7695—
--ringbg-ring#0f2340#f29a0a—
--successtext-success#1f7a4d#5fd39b5.3 : 1 / 8.4 : 1
--success-mutedbg-success-muted#e8f5ee#12352a—
--dangertext-danger#b42318#f980806.6 : 1 / 6.3 : 1
--danger-mutedbg-danger-muted#fdecea#3a1d1f—
--infotext-info#1d5fa8#7eb8f26.5 : 1 / 7.5 : 1
--info-mutedbg-info-muted#e8f1f9#12304d—
--warningtext-warning#8f5200#f5b45c6.2 : 1 / 8.7 : 1
--warning-mutedbg-warning-muted#fff4e0#3a2a0e—

--page und --background

Beide Tokens sind Flächen, haben aber unterschiedliche Rollen:

  • --page ist der Grund der ganzen Seite. Im hellen Theme ist er #f5f8fc (Cloud), im dunklen #0a1628 (Navy Deep). html und body bekommen diese Fläche; Navigation, Kopfzeilen und der Bereich hinter dem Inhalt liegen darauf.
  • --background ist die Inhaltsfläche darüber: #ffffff in hell, #0f2340 (Navy) in dunkel. Karten und Eingaben setzen mit --card und --popover noch eine Stufe heller an.

Die Regel ist einfach: bg-page für den Seitenrahmen, bg-background für die Fläche, auf der Text und Formulare stehen. Beide Namen existieren in beiden Themes, deshalb braucht kein Produkt eine Fallunterscheidung.

Statusfarben

Status wird nie nur über Farbe transportiert, sondern immer mit Icon und Text. Zu jedem Status gehören zwei Tokens: die kräftige Textfarbe und eine gedämpfte Fläche für Hinweise und Abzeichen.

StatusTextFlächeHell / Dunkel
Erfolg--success--success-muted#1f7a4d / #5fd39b
Gefahr--danger--danger-muted#b42318 / #f98080
Hinweis--info--info-muted#1d5fa8 / #7eb8f2
Warnung--warning--warning-muted#8f5200 / #f5b45c

--destructive trägt denselben Wert wie --danger; text-destructive ist der Alias für text-danger. bg-warning-bg bleibt als Alias aus Version 0.1.0 für bg-warning-muted bestehen. Neue Oberflächen verwenden bg-warning-muted.

Diagramm-Tokens

Diagramme haben eine eigene Reihe, damit sie in beiden Themes lesbar bleiben:

TokenHellDunkel
--chart-1#0f2340#a8bdd8
--chart-2#52647e#7e93ad
--chart-3#1d5fa8#7eb8f2
--chart-4#1f7a4d#5fd39b
--chart-5#f29a0a#f29a0a

Die Charts der Library lesen sie über chartColor beziehungsweise var(--chart-1) bis var(--chart-5); als Utility stehen bg-chart-1 bis bg-chart-5 bereit. Orange bleibt der Akzent und trägt nie allein eine Aussage.

Dichte

NeodinProvider setzt data-density auf seine Hülle. Zwei Variablen machen daraus die tatsächlichen Maße:

Variablecomfortable (Standard)compact
--control-h2.25rem1.875rem
--cell-py0.75rem0.375rem

--control-h steuert die Höhe von Eingabefeldern, --cell-py den Innenabstand von Tabellenzellen. Komponenten lesen die Variablen, statt feste Höhen zu setzen – deshalb wirkt density="compact" sofort in allen Eingaben und in der DataTable. Mehr dazu unter NeodinProvider.

Radius

Die Marke ist kantig: --radius ist 6px. Die Tailwind-Stufen leiten davon ab, damit alle Ecken zusammenpassen:

  • rounded-xs und rounded-sm: calc(var(--radius) - 2px), also 4 px
  • rounded-md: var(--radius), also 6 px
  • rounded-lg: calc(var(--radius) + 2px), also 8 px
  • rounded-xl: calc(var(--radius) + 6px), also 12 px

Schatten bleiben Overlays vorbehalten; Flächen trennen sich über Linien und Abstand.

Schriften

Beide Schriften sind selbst gehostet und kommen über @fontsource mit dem Paket; es gibt keinen CDN-Aufruf.

  • Manrope in den Schnitten 400, 500, 600 und 800. --font-sans setzt sie als Grundschrift; der Fließtext läuft in 500 mit Zeilenhöhe 1,6.
  • JetBrains Mono in 400 für Code, Tastenkürzel und Zahlen in Tabellen (--font-mono).
  • Überschriften h1 und h2 sind 800 mit −0,02 em Laufweite, h3 ist 600. Der Kicker über Seitentiteln ist 600, in Großbuchstaben und nutzt --warning (#8f5200 hell, #f5b45c dunkel).

Weiterlesen