📘 Przewodnik

Single Source of Truth

Single Source of Truth (SSOT) to zasada, że Design System ma jedno źródło prawdy — jedno miejsce, gdzie zdefiniowane są aktualne wartości, style i komponenty.

Co to jest?

Single Source of Truth w kontekście Design Systemu oznacza, że istnieje jedno autorytatywne źródło dla każdej decyzji projektowej. Nie ma duplikatów, rozbieżności ani konkurujących wersji. Jeśli kolor primary to #6366F1, to ta wartość jest zdefiniowana w JEDNYM miejscu i referencowana wszędzie indziej. SSOT eliminuje problem „która wersja jest aktualna?”

Jak to działa?

SSOT działa na zasadzie jednego źródła i wielu konsumentów. Źródłem mogą być Figma Variables (design) lub JSON token file (kod). Narzędzia synchronizacji (Tokens Studio, Style Dictionary) eksportują tokeny do CSS, iOS, Android z tego jednego źródła. Zmiana w źródle automatycznie propaguje się do wszystkich platform.

Jak wdrożyć?

01
Zdecyduj, co jest źródłem: Figma Variables, JSON, YAML.
02
Zdefiniuj pipeline: źródło → transformacja → eksport do platform.
03
Skonfiguruj Style Dictionary lub Tokens Studio.
04
Zautomatyzuj synchronizację (CI/CD, GitHub Actions).
05
Eliminuj hardcoded values — wszystko przez tokeny.
06
Monitoruj dryft (narzędzia do wykrywania hardcoded values).
07
Edukuj zespół: „nigdy nie kopiuj wartości, zawsze referencuj token”.

Przykłady z prawdziwych Design Systemów

Salesforce Lightning używa centralized token repository z automatycznym eksportem do Web, iOS i Android. Atlassian synchronizuje Figma Variables z kodem przez dedykowany pipeline. Carbon IBM eksportuje tokeny z SCSS do CSS Custom Properties, JSON i iOS/Android.

Powiązane hasła ze Słowniczka

📖 Single Source Of Truth 📖 Design Tokens 📖 Design System

Powiązane przewodniki

Naucz się tego w praktyce

Naucz się budować Single Source of Truth

Sprawdź Design System Masterclass →