Grundlagen
Design-Tokens
StabilFlä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.
| Farbfeld | Token | Utility | Hell | Dunkel | Kontrast |
|---|---|---|---|---|---|
--page | bg-page | #f5f8fc | #0a1628 | — | |
--background | bg-background | #ffffff | #0f2340 | — | |
--foreground | text-foreground | #0f2340 | #f5f8fc | 15.7 : 1 / 14.8 : 1 | |
--card | bg-card | #ffffff | #0f2340 | — | |
--card-foreground | text-card-foreground | #0f2340 | #f5f8fc | 15.7 : 1 / 14.8 : 1 | |
--popover | bg-popover | #ffffff | #0f2340 | — | |
--popover-foreground | text-popover-foreground | #0f2340 | #f5f8fc | 15.7 : 1 / 14.8 : 1 | |
--primary | bg-primary | #0f2340 | #f5f8fc | — | |
--primary-foreground | text-primary-foreground | #ffffff | #0f2340 | 15.7 : 1 / 14.8 : 1 | |
--secondary | bg-secondary | #e8eef6 | #1c3557 | — | |
--secondary-foreground | text-secondary-foreground | #0f2340 | #f5f8fc | 13.5 : 1 / 11.6 : 1 | |
--muted | bg-muted | #eef3f9 | #16294a | — | |
--muted-foreground | text-muted-foreground | #52647e | #9db0c8 | 5.4 : 1 / 6.5 : 1 | |
--accent | bg-accent | #e4edf8 | #1d3a5e | — | |
--accent-foreground | text-accent-foreground | #0f2340 | #f5f8fc | 13.3 : 1 / 10.8 : 1 | |
--destructive | bg-destructive | #b42318 | #f98080 | — | |
--destructive-foreground | text-destructive-foreground | #ffffff | #0f2340 | 6.6 : 1 / 6.3 : 1 | |
--border | bg-border | #d3ddea | #26405f | — | |
--input | bg-input | #74869c | #5a7695 | — | |
--ring | bg-ring | #0f2340 | #f29a0a | — | |
--success | text-success | #1f7a4d | #5fd39b | 5.3 : 1 / 8.4 : 1 | |
--success-muted | bg-success-muted | #e8f5ee | #12352a | — | |
--danger | text-danger | #b42318 | #f98080 | 6.6 : 1 / 6.3 : 1 | |
--danger-muted | bg-danger-muted | #fdecea | #3a1d1f | — | |
--info | text-info | #1d5fa8 | #7eb8f2 | 6.5 : 1 / 7.5 : 1 | |
--info-muted | bg-info-muted | #e8f1f9 | #12304d | — | |
--warning | text-warning | #8f5200 | #f5b45c | 6.2 : 1 / 8.7 : 1 | |
--warning-muted | bg-warning-muted | #fff4e0 | #3a2a0e | — |
--page und --background
Beide Tokens sind Flächen, haben aber unterschiedliche Rollen:
--pageist der Grund der ganzen Seite. Im hellen Theme ist er#f5f8fc(Cloud), im dunklen#0a1628(Navy Deep).htmlundbodybekommen diese Fläche; Navigation, Kopfzeilen und der Bereich hinter dem Inhalt liegen darauf.--backgroundist die Inhaltsfläche darüber:#ffffffin hell,#0f2340(Navy) in dunkel. Karten und Eingaben setzen mit--cardund--popovernoch 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.
| Status | Text | Fläche | Hell / 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:
| Token | Hell | Dunkel |
|---|---|---|
--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:
| Variable | comfortable (Standard) | compact |
|---|---|---|
--control-h | 2.25rem | 1.875rem |
--cell-py | 0.75rem | 0.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-xsundrounded-sm:calc(var(--radius) - 2px), also 4 pxrounded-md:var(--radius), also 6 pxrounded-lg:calc(var(--radius) + 2px), also 8 pxrounded-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-sanssetzt 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
h1undh2sind 800 mit −0,02 em Laufweite,h3ist 600. Der Kicker über Seitentiteln ist 600, in Großbuchstaben und nutzt--warning(#8f5200hell,#f5b45cdunkel).
Weiterlesen
- Hell und dunkel: wie die Theme-Klasse gesetzt wird und warum Produkte nur semantische Utilities verwenden.
- Farbschema (ThemeProvider, ThemeToggle): der Umschalter als Komponente.