Tokens

Neon nutzt Tailwind v4 @theme als Single Source of Truth in addxion-neon/packages/core/src/tokens/.

Schichten

Schicht	Datei	Zweck
Primitives	primitives.css	Farben (accent, info, tip, destructive, success, warning), Radius, Fluid Typography, Font-Stack
Brand	brand.css	[data-brand] Overrides — Mechanismus in Neon, Werte beim Consumer
Semantic	semantic.css	Intent-Tokens via @theme inline + theme()
Starlight-Bridge	tokens/starlight-bridge.css	Neon Semantic → Starlight --sl-color-*
Docs-Prose	docs/prose.css	Starlight MDX-Komponenten (Cards, Asides, Badges, Tabs, Steps)
shadcn-Bridge	tokens/shadcn-bridge.css	Neon Semantic → --background, --foreground, …
Fonts	fonts/inter.css	Self-hosted Inter — siehe Typografie

Semantic Tokens

Token	Verwendung
primary / primary-foreground	CTAs, Akzente
secondary / secondary-foreground	Sekundäre Flächen
muted / muted-foreground	Dezente Hintergründe
accent / accent-foreground	Highlights, Badges
surface, text, text-muted	Flächen und Fließtext
card / card-foreground	Card-Flächen
code-background, mark-background	Code-Blöcke, Highlights
info / info-foreground	Docs-Asides (note)
tip / tip-foreground	Docs-Asides (tip)
border, input, ring	Rahmen, Formulare, Focus
destructive	Fehler, Löschen
success, warning	Status
popover	Overlays

Docs-Exports

Starlight-Consumers importieren:

@import "@addxion/neon/tokens/starlight-bridge.css";
@import "@addxion/neon/docs/prose.css";

Brand-Werte setzt der Consumer in brand.css via --brand-color-*.

Semantic Colors

primary

secondary

muted

surface

destructive

success

warning

text

Fluid Typography

text-sm — fluid

text-base — fluid

text-lg — fluid

text-xl — fluid

text-hero — fluid

Brand Override

Warm Brand (demo-warm)

Consumer setzen --brand-color-* in brand.css (addxion.com) oder [data-brand].

Truths

ID	Wahrheit
T-PKG-NEON	Consumer-Einstieg: @addxion/neon, nicht @addxion/core
T-NEON-BRAND	Markenwerte in Consumer brand.css
T-TRUTHS-SSOT	Truths-Registry — referenzieren, nicht duplizieren

Für Agents

Scope: Semantic Tokens und tw:-Utilities.

• Tokens in addxion-neon pflegen, nicht in Consumern duplizieren
• Consumer importieren @addxion/neon/styles