Fertigkeit: Token-Build
Wandle die DTCG-Token-Quelle der Wahrheit in plattformreife Ausgaben um. Tokens werden einmal erstellt; jede Plattformausgabe wird generiert.
Schritte
- Lese
workflows/token-build.md(Architektur, Tool-Optionen, Auflösungsregeln, Ausgabeziele, CI). - Wähle das Werkzeug: Style Dictionary (Multi-Plattform, Standard), Tokens Studio (Figma-eigene Tokens – paart sich mit
figma-integration), W3C-DTCG-Export oder ein kleines benutzerdefiniertes Skript (Vorbildscripts/validate_tokens.py). - Beachte die Auflösungsregeln: löse Aliase zu endgültigen Werten je Plattform auf; gib semantische + Komponenten-Tokens nach außen (Primitives bleiben intern); erzeuge Basis + Dark/Brand/Density-Überschreibungen (
tokens/theming.json) nur als Deltas; formatiere nach$type. - Generiere die angefragte(n) Zielplattform(en): CSS
:root-Variablen, Tailwind v4@theme, typisiertes JS/TS, iOS-Asset-Katalog +Color.DS/Spacing, Androidcolors.xml/Compose-Theme. - Richte CI ein: bei Änderungen an
tokens/*.jsonführescripts/validate_tokens.pyaus, generiere neu, schlage fehl, wenn eingecheckte Artefakte veraltet sind; schalte Farben mitscripts/contrast.py.
Verifikation (Definition of Done)
python3 scripts/validate_tokens.pybesteht (keine unaufgelösten Aliase).- Neugenerierung erzeugt keinen Diff zu den eingecheckten Artefakten.
- Dark/Brand/Density-Ausgaben enthalten nur Deltas, keine vollständigen Duplikate.