Files
vendoo/docs/architecture/DESIGN_SYSTEM_1_35_0.md
Masterluke77andGitHub 6f48827f4d Vendoo 1.41.2 – Git Ignore Boundary & Module Tracking Hotfix (#18)
* docs: prepare Vendoo 1.41.2 git-ignore boundary hotfix

* fix: track native source modules with root-anchored runtime ignores
2026-07-09 17:09:00 +02:00

1.2 KiB
Raw Permalink Blame History

Vendoo 1.35.0 Design-System- und Theme-Vertrag

Quelle der Wahrheit

Die editierbare Tokenquelle liegt unter:

public/design-system/tokens/source.json

Aus ihr erzeugt tools/generate-design-tokens.mjs deterministisch:

  • public/design-system/tokens.css
  • public/design-system/theme-contract.json

Direkte Änderungen an tokens.css sind nicht zulässig.

Ebenen

  • Primitive/semantische Farb-, Radius-, Schatten-, Dichte-, Layout- und Bewegungswerte
  • CSS-Variablen mit Präfix --vd-*
  • Kompatibilitätsbrücke für bestehende Variablen wie --bg, --accent und --radius

Themes

  1. light
  2. dark
  3. contrast
  4. Browserpräferenz system über die Theme Runtime

Sicherheit

Der zukünftige Theme Manager darf ausschließlich Tokens mit customizable: true verändern. Freies CSS, HTML, URLs, JavaScript, Schattenausdrücke und beliebige Variablennamen sind nicht erlaubt. Farben und Dimensionen werden typ- und bereichsgeprüft. Ein Theme wird nie ungeprüft als Stylesheet gespeichert.

Nächster Ausbau

  • persistente Themes pro Benutzer und systemweit
  • Live-Vorschau in isoliertem Vorschaucontainer
  • automatische Kontrastprüfung
  • Import/Export eines versionierten Theme-JSON
  • Versionsverlauf und Zurücksetzen