Figma ist nicht die Single Source of Truth für Design Tokens

Ich habe meine Meinung zum Umgang mit Design Tokens geändert, und ich gehe nicht zurück. Nach Jahren der Arbeit mit Designsystemen bin ich überzeugt: Figma sollte nicht die Single Source of Truth für Design Tokens sein. Figma sollte sie stattdessen nutzen.

Der klassische Ansatz: Figma als Quelle

Viele Teams beginnen mit Design Tokens über Figma-Plugins, die Tokens aus den Designdateien exportieren. Zunächst wirkt das logisch: Die Designerinnen und Designer arbeiten in Figma, warum also die Tokens nicht direkt dort herausziehen?

Das Problem ist ein grundlegender Architekturfehler: Das Fundament Ihres Designsystems liegt in einem proprietären Designwerkzeug und ist nur über dessen API und Plugin-Ökosystem erreichbar.

Der bessere Weg: Code als Single Source of Truth

Ich empfehle heute: Design Tokens gehören in eine versionierte JSON-Datei in Ihrer Codebasis. Diese Datei ist die einzige maßgebliche Quelle, und sowohl der Anwendungscode als auch Figma beziehen ihre Werte daraus.

Warum das wichtig ist

Versionierung: Liegen Tokens in einer JSON-Datei, profitieren sie von Git. Sie bekommen:

  • Eine vollständige Änderungshistorie mit aussagekräftigen Commit-Nachrichten
  • Code-Reviews für Token-Änderungen
  • Einfache Rollbacks, wenn etwas schiefgeht
  • Branch-basierte Workflows für Experimente mit Tokens

Zugänglichkeit für die Entwicklung: Entwicklerinnen und Entwickler können Tokens lesen, ändern und verstehen, ohne Zugang zu Figma zu brauchen oder sich durch Designdateien zu klicken. Die Tokens liegen genau dort im Code, wo sie verwendet werden.

Automatisierung und CI/CD: Mit Tokens in JSON können Sie:

  • Prüfungen in Ihrer CI-Pipeline ausführen
  • Dokumentation automatisch erzeugen
  • Tokens in plattformspezifische Formate umwandeln (CSS, SCSS, JavaScript, iOS, Android)
  • Breaking Changes abfangen, bevor sie in Produktion gehen

Unabhängigkeit vom Werkzeug: Ihr Designsystem ist nicht an Figma gebunden. Wenn Sie das Werkzeug wechseln, Plattformen migrieren oder mehrere Designwerkzeuge unterstützen müssen, bleiben Ihre Tokens stabil und erreichbar.

W3C-Konformität: Tokens in JSON können der W3C-Spezifikation für Design Tokens folgen. Das sichert Austauschbarkeit und Zukunftsfähigkeit.

Figma als Nutzer

Statt aus Figma zu exportieren, importieren Sie Tokens in Figma. Das heißt:

  1. Tokens werden in der JSON-Datei geändert (oder über den Prozess Ihres Teams angefragt)
  2. Tokens werden geprüft und in die Codebasis übernommen
  3. Dieselben Tokens werden per Import-Plugin nach Figma synchronisiert
  4. Code und Design bleiben aus einer einzigen Quelle perfekt synchron

Warum ich keine Export-Plugins mehr nutze

Ich verwende in meiner Arbeit keine Figma-Plugins zum Export von Tokens mehr, weil sie die Abhängigkeit in die falsche Richtung drehen. Sie machen den Code vom Zustand des Designwerkzeugs abhängig, obwohl es umgekehrt sein sollte.

Export-Plugins führen außerdem oft dazu, dass:

  • manuelle Eingriffe nötig sind, um alles synchron zu halten
  • Inkonsistenzen entstehen, je nachdem, wie Dateien aufgebaut sind
  • die Prüfung und Steuerung fehlen, die Tokens im Code bieten
  • eine Lücke entsteht zwischen dem, was in der Versionsverwaltung liegt, und dem, was in Produktion läuft

Das Umdenken

Dieser Ansatz verlangt ein Umdenken: Design Tokens sind Code, keine Designdateien. Sie sind der Vertrag zwischen Design und Entwicklung, und wie jeder Vertrag müssen sie versioniert, geprüft und mit derselben Sorgfalt verwaltet werden wie Ihr Anwendungscode.

Figma ist ein großartiges Werkzeug für die Gestaltung, aber es ist weder als Versionsverwaltung noch als maßgebliche Quelle für das gestalterische Fundament Ihres Produkts gebaut. Lassen Sie Figma tun, was es am besten kann – eine Fläche für Kreativität und Zusammenarbeit sein –, während Ihre Design Tokens dort leben, wo sie hingehören: im Code.

„Die maßgebliche Quelle sollte dort liegen, wo sie sauber versioniert, geprüft und von allen Beteiligten gleichermaßen genutzt werden kann.“

Loslegen

Wenn Sie diesen Ansatz übernehmen möchten:

  1. Definieren Sie Ihre Tokens in JSON nach der W3C-Spezifikation
  2. Richten Sie eine Prüfung ein (Tools wie der Design Token Validator helfen dabei)
  3. Erstellen Sie Build-Skripte, die Tokens in plattformspezifische Formate umwandeln
  4. Nutzen Sie Import-Plugins für Figma, um Tokens in Ihre Designdateien zu synchronisieren
  5. Etablieren Sie einen Prozess für Token-Änderungen mit Code-Review

Ihr zukünftiges Ich wird Ihnen für diese frühe Architekturentscheidung danken.

Sie möchten Ihre Tokens in den Code holen? Dabei unterstütze ich mit UX-Audit und Designsystem-Aufbau.