Designsystem
Übersicht
Ein Designsystem ist der Ort, an dem eine Entscheidung einmal getroffen und dann überall wiederverwendet wird. Jede Farbe ist ein Token, jedes interaktive Element zeigt alle seine Zustände, und jede Änderung erreicht jeden Bildschirm, der das Element verwendet. Baue es schichtweise auf, zuerst die Grundlagen, und halte für jede Schicht zur Freigabe an. Ein Audit berichtet und repariert nie von selbst.
Wann verwenden
- "Erstelle einen Styleguide / ein Designsystem / Tokens für …"
- Hinzufügen einer Komponente, Variante oder eines Tokens, oder Ändern einer vorhandenen.
- "Diese Bildschirme konsistent machen", "standardisieren", "den Guide prüfen" oder lose Hex-Werte und Einzelstücke in den Bildschirmen.
Wann NICHT verwenden
- Eine Frage zu einem einzelnen Wert ("Was ist unsere Primärfarbe?"): beantworte sie.
- Eine kleine Änderung, die die Person genau beschrieben hat (ein Wert, ein Label, eine Größe), selbst an einem gemeinsam genutzten Element: ändere es einmal an der Stelle, wo es definiert ist, und sage, welche Bildschirme betroffen sind. Keine Zustandsmatrix, kein Stopp.
Bevor du beginnst
- Lies
DESIGN.mdim Projekt-Root, falls vorhanden: Es ist das Design-Briefing des Projekts. - Finde heraus, was existiert: Tokens, der Guide, die Komponenten, die Bildschirme und der Code. Ein vorhandener Guide gewinnt im Aussehen. Folge seinen Regeln, auch wenn sie von den untenstehenden Standardeinstellungen abweichen, und erwähne die Abweichung einmal.
- Wähle den Adapter deines Tools in
references/adapters/(paper.md,figma.md,html.md). Wenn kein Adapter zu deinem Tool passt, führe die gleichen Verben in deinem Tool aus und sage, welche du von Hand zugeordnet hast. Ohne Design-Tool überhaupt, baue in HTML (html.md). Wenn du nur ein Bild hast, sage, dass daraus gelesene Werte Schätzwerte sind. - Entscheide den Modus: erstellen, hinzufügen oder ändern oder prüfen.
Schritte · Erstellen
-
Grundlagenentwurf:
- Farbrollen (Token-Rollen);
- Schriftgrößensystem;
- Abstände;
- Radius;
- Schatten (höchstens zwei);
- Layout-Breiten;
- Bewegungsdauern;
- ein kurzer Abschnitt "Wie wir schreiben".
Benenne Tokens nach Rolle (
text-muted,border-hover,danger-bg), niemals nur nach Wert (gray-500). -
Interaktionsregeln, einmal: für Elemente mit Rahmen, ohne Rahmen und die primäre Aktion schreibe, wie Hover, Gedrückt, Fokus (nur Tastatur), Deaktiviert, Laden und Ausgewählt aussehen. Komponenten folgen diesen Regeln, anstatt eigene zu erfinden.
-
Halte an und zeige der Person die Grundlagen und die Interaktionsregeln. Baue noch keine Komponenten.
-
Komponenten eine nach der anderen, in der Reihenfolge, in der die ersten Bildschirme sie benötigen. Jede erhält einen Guide-Abschnitt mit der Komponenten-Anatomie: eine Legende mit der Regel und dem Warum, Beispiele und eine Zustandsmatrix von Varianten × Zuständen. Füge jede zum Komponentenindex hinzu.
Schritte · Ein Element hinzufügen oder ändern
- Prüfe, ob eine vorhandene Komponente plus eine Variante es abdeckt. Bevorzuge Wiederverwendung gegenüber einem Einzelstück.
- Zeichne es mit der Anatomie, einschließlich der vollständigen Zustandsmatrix. Eine neue Farbe, Größe oder ein neues Icon wird jetzt zu einem Token oder Icon-Set-Eintrag, nicht später.
- Liste jeden Bildschirm und jede Code-Stelle auf, die das Element verwendet.
- Halte an und zeige der Person die Änderung und diese Liste.
- Nach Genehmigung: propagieren:
- aktualisiere jeden Bildschirm auf der Liste;
- aktualisiere den Code, falls vorhanden;
- aktualisiere den Komponentenindex;
- berichte, was wo geändert wurde.
Schritte · Prüfen
- Führe die Prüfliste über den Guide, die Bildschirme und den Code aus, falls vorhanden.
- Schreibe den Bericht: Ergebnisse nach Schweregrad geordnet, jeweils mit Angabe des Ortes, des Grundes und des vorgeschlagenen Fixes.
- Halte an und zeige der Person den Bericht. Ändere keine Datei, bis sie sagt, welche Fixes gemacht werden sollen. Das Speichern von Kopien der Originale macht das Bearbeiten nicht akzeptabel.
Regeln
Fest (jedes Projekt):
| Regel | Warum |
|---|---|
| Jede Farbe ist ein Token; keine losen Hex-Werte in Bildschirmen oder Code | Lose Werte entwickeln sich zu fast identischen Duplikaten, die niemand auf einmal ändern kann |
| Ein Icon-Set | Gemischte Sets sehen aus wie gemischte Produkte |
| Design und Code ändern sich gemeinsam, Design zuerst | Sonst ist der Guide innerhalb einer Woche nicht mehr die Wahrheit |
| Jedes interaktive Element hat eine Zustandsmatrix | Ad-hoc gezeichnete Zustände auf Bildschirmen stimmen nie überein |
| Eine Änderung an einem gemeinsam genutzten Element wird mit den betroffenen Bildschirmen aufgelistet, bevor sie propagiert wird | Sonst gestaltet eine "kleine" Änderung leise zwanzig Bildschirme um |
Standardeinstellungen (ein vorhandener Guide überschreibt sie):
| Standard | Warum |
|---|---|
| Bei Hover verdunkeln Elemente mit Rahmen nur den Rahmen | Ein sich ändernder Hintergrund auf Karten und Feldern wirkt schwerfällig |
| Hover ist dezenter als Ausgewählt | Wenn Hover wie Ausgewählt aussieht, denken Leute, zwei Dinge seien ausgewählt |
| Auswählen ändert nie die Schriftstärke | Eine Gewichtsänderung verschiebt die Textbreite |
| Platzhalter sind heller als deaktivierter Text | Sonst liest sich ein Platzhalter wie eingegebener Text |
| Elemente in gestapelten Listen und Menüs haben einen kleinen Abstand, nie berührend | Berührende Hervorhebungen verschmelzen zu einem Block |
| Der Fokusring erscheint nur über die Tastatur | Ein Ring nach einem Mausklick sieht aus wie ein Fehler |
| Laden behält die exakte Größe des Elements | Layout-Verschiebung |
| Schatten nur auf schwebenden Dingen (Menüs, Popover, Dialoge, Toasts) in zwei Stärken | Schatten überall flachen die Hierarchie, die sie erzeugen sollten |
| Maximal eine primäre Aktion pro Bildschirm | Zwei Primäre bedeuten, der Bildschirm hat sich nicht entschieden |
Fertig, wenn
- Erstellen: Grundlagen und Interaktionsregeln genehmigt; jede Komponente hat ihre Anatomie, Zustandsmatrix und einen Indexeintrag.
- Ändern: Jeder gelistete Bildschirm und jede Code-Stelle aktualisiert und der Index aktualisiert.
- Prüfen: Ein geordneter Bericht geliefert und keine Datei geändert.
Häufige Fehler
| Gedanke | Realität |
|---|---|
| "Ich baue den ganzen Guide auf einmal: Tokens und zehn Komponenten" | Zehn Komponenten auf nicht genehmigten Grundlagen bedeuten zehn Überarbeitungen. Grundlagen, Stopp, dann Komponenten. |
| "Das Audit hat Probleme gefunden, ich korrigiere sie einfach" | Die Person ist vielleicht mit der Hälfte der Korrekturen nicht einverstanden. Bericht, Stopp, korrigiere nur, was sie auswählt. |
| "Ich habe die Originale in einem Backup-Ordner behalten, also ist Korrigieren sicher" | Ein Backup sorgt nicht dafür, dass die Person mit den Korrekturen einverstanden ist. Bericht zuerst. |
| "Buttons haben Hover und Deaktiviert, das reicht" | Eine Zustandsmatrix hat jeden Zustand × jede Variante: Normal, Hover, Gedrückt, Fokus, Deaktiviert, Laden, Ausgewählt. |
"--teal-600 ist ein Token" | Es ist ein Wert. Komponenten brauchen Rollen (--color-primary), damit der Wert an einer Stelle geändert werden kann. |
| "Dieser Bildschirm braucht eine leicht andere Karte" | Mach sie zu einer Variante der Karte oder verwende die Karte. Ein Einzelstück ist der Beginn von Abweichung. |