amzn/style-dictionary
Style Dictionary
Style Dictionary ist ein plattformübergreifender Style-Generator und ein Build-System für Design-Tokens. Es konvertiert eine einzelne Quelle von Design-Variablen in mehrere Ausgabeformate und plattformspezifische Dateien, um eine konsistente Single Source of Truth über verschiedene Interfaces hinweg zu wahren.
Das System fungiert als Multi-Format-Style-Orchestrator, der modulare Token-Quellen zusammenführt und basierend auf den Anforderungen der Zielplattform transformiert. Es nutzt ein skriptfähiges Transform-Interface, um Token-Werte und -Namen zu modifizieren, was die Automatisierung von Design-System-Styles für Web-, iOS- und Android-Anwendungen ermöglicht.
Der Build-Prozess ist konfigurationsgesteuert und nutzt ein zentrales Objekt, um Token-Sets auf Transformations- und Ausgaberegeln zu mappen. Es verwendet eine Intermediate Representation, um die Quell-Tokens agnostisch gegenüber der Zielplattform zu halten, während steckbare Format-Adapter definieren, wie verarbeitete Tokens in spezifische Zielformate geschrieben werden.
Features
- Design Tokens - Converts a single source of design variables into multiple platform-specific formats to ensure visual consistency.
- Design Token Exporters - Manages design variables and exports them to platform-specific formats like Tailwind, CSS, or JSON.
- Platform Build File Generators - Generates platform-specific styled output files in various formats based on a central configuration.
- Cross-Platform Style Generators - Acts as a generator that converts a single source of design variables into multiple output formats for various platforms.
- Design Token Transformers - Transforms raw design data into the specific naming conventions and value formats required by various development environments.
- Token Merging - Combines multiple modular design token source files into a single unified set to maintain a consistent source of truth.
- Design Token Systems - Provides a comprehensive system for managing design properties through hierarchical variables and platform-specific build processes.
- Design System Automation Tools - Automates the conversion of design tokens into platform-specific code to maintain consistency across different products.
- Cross-Platform Styling - Provides an architecture to define global style variables once and apply them across web, iOS, and Android platforms.
- Format Adapters - Provides pluggable format adapters that allow developers to define custom output file types and destination paths.
- Build Configuration Architectures - Implements a configuration-driven architecture using JSON or JS to map design tokens to specific output rules.
- Value Transformations - Provides transformation functions to modify token values and names based on the requirements of the target platform.
- Sequential Transformation Pipelines - Processes design tokens through a strict sequential pipeline of functions to modify values and names.
- Style Orchestrators - Functions as an orchestrator that merges modular token sources and exports them into multiple destinations via central configuration.
- Intermediate Representations - Uses an intermediate representation to decouple source design tokens from the final platform-specific output formats.
- Scriptable Processing Pipelines - Exposes a scriptable interface for injecting custom logic into the sequential token transformation pipeline.
- Build Logic Extensions - Allows developers to extend build logic via custom scripts for project-specific data transformations and output formats.
- Design Token Management - Cross-platform build system for managing design tokens.
