/design-system
Wenn Ihnen unbekannte Platzhalter begegnen oder Sie prüfen müssen, welche Tools verbunden sind, lesen Sie CONNECTORS.md.
Verwalten Sie Ihr Designsystem – prüfen Sie es auf Konsistenz, dokumentieren Sie Komponenten oder entwerfen Sie neue Muster.
Verwendung
/design-system audit # Vollständige Systemprüfung
/design-system document [component] # Eine Komponente dokumentieren
/design-system extend [pattern] # Eine neue Komponente oder ein Muster entwerfen
Bestandteile eines Designsystems
Design-Token
Atomare Werte, die die visuelle Sprache definieren:
- Farben (Marke, semantisch, neutral)
- Typografie (Schriftgrößen, Gewichte, Zeilenhöhen)
- Abstände (Skala, Abstände innerhalb von Komponenten)
- Rahmen (Radius, Breite)
- Schatten (Höhenstufen)
- Bewegung (Dauern, Beschleunigungen)
Komponenten
Wiederverwendbare UI-Elemente mit definierten:
- Varianten (primär, sekundär, Geist)
- Zuständen (Standard, Hover, Aktiv, Deaktiviert, Laden, Fehler)
- Größen (sm, md, lg)
- Verhalten (Interaktionen, Animationen)
- Barrierefreiheit (ARIA, Tastatur)
Muster
Häufige UI-Lösungen, die mehrere Komponenten kombinieren:
- Formulare (Eingabegruppen, Validierung, Absenden)
- Navigation (Sidebar, Tabs, Breadcrumbs)
- Datenanzeige (Tabellen, Karten, Listen)
- Feedback (Toasts, Modale, Inline-Nachrichten)
Grundsätze
- Konsistenz vor Kreativität – Das System existiert, damit Teams das Rad nicht neu erfinden.
- Flexibilität innerhalb von Grenzen – Komponenten sollten kombinierbar, nicht starr sein.
- Alles dokumentieren – Wenn es nicht dokumentiert ist, existiert es nicht.
- Versionieren und migrieren – Breaking Changes benötigen Migrationspfade.
Ausgabe – Prüfung
## Designsystem-Prüfung
### Zusammenfassung
**Geprüfte Komponenten:** [X] | **Gefundene Probleme:** [X] | **Punktzahl:** [X/100]
### Namensgebungskonsistenz
| Problem | Komponenten | Empfehlung |
|---------|-------------|------------|
| [Inkonsistente Benennung] | [Liste] | [Zu übernehmender Standard] |
### Token-Abdeckung
| Kategorie | Definiert | Hartcodierte Werte gefunden |
|-----------|-----------|------------------------------|
| Farben | [X] | [X] Instanzen von hartcodiertem Hex |
| Abstände | [X] | [X] Instanzen von willkürlichen Werten |
| Typografie | [X] | [X] Instanzen von benutzerdefinierten Schriftarten/-größen |
### Vollständigkeit der Komponenten
| Komponente | Zustände | Varianten | Doku | Punktzahl |
|------------|----------|-----------|------|-----------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### Prioritäre Maßnahmen
1. [Wirkungsvollste Verbesserung]
2. [Zweite Priorität]
3. [Dritte Priorität]
Ausgabe – Dokumentieren
## Komponente: [Name]
### Beschreibung
[Wofür diese Komponente ist und wann sie verwendet werden soll]
### Varianten
| Variante | Wann verwenden |
|----------|----------------|
| [Primär] | [Hauptaktionen] |
| [Sekundär] | [Unterstützende Aktionen] |
### Props / Eigenschaften
| Eigenschaft | Typ | Standard | Beschreibung |
|-------------|-----|----------|---------------|
| [prop] | [typ] | [standard] | [beschreibung] |
### Zustände
| Zustand | Visuell | Verhalten |
|---------|---------|-----------|
| Standard | [beschreibung] | — |
| Hover | [beschreibung] | [interaktion] |
| Aktiv | [beschreibung] | [interaktion] |
| Deaktiviert | [beschreibung] | Nicht interaktiv |
| Laden | [beschreibung] | [animation] |
### Barrierefreiheit
- **Rolle**: [ARIA-Rolle]
- **Tastatur**: [Tab, Eingabe, Escape-Verhalten]
- **Screenreader**: [Wird angesagt als...]
### Dos and Don'ts
| ✅ Do | ❌ Don't |
|---------|----------|
| [Best Practice] | [Anti-Pattern] |
### Codebeispiel
[Framework-entsprechender Codeausschnitt]
Ausgabe – Erweitern
## Neue Komponente: [Name]
### Problem
[Welches Benutzerbedürfnis oder welche Lücke diese Komponente adressiert]
### Vorhandene Muster
| Verwandte Komponente | Ähnlichkeit | Warum sie nicht ausreicht |
|----------------------|-------------|----------------------------|
| [Komponente] | [Was gemeinsam ist] | [Was fehlt] |
### Vorgeschlagenes Design
#### API / Props
| Eigenschaft | Typ | Standard | Beschreibung |
|-------------|-----|----------|---------------|
| [prop] | [typ] | [standard] | [beschreibung] |
#### Varianten
| Variante | Wann verwenden | Visuell |
|----------|----------------|---------|
| [Variant] | [Szenario] | [Beschreibung] |
#### Zustände
| Zustand | Verhalten | Hinweise |
|---------|-----------|----------|
| Standard | [Beschreibung] | — |
| Hover | [Beschreibung] | [Interaktion] |
| Deaktiviert | [Beschreibung] | Nicht interaktiv |
| Laden | [Beschreibung] | [Animation] |
#### Verwendete Token
- Farben: [Welche Token]
- Abstände: [Welche Token]
- Typografie: [Welche Token]
### Barrierefreiheit
- **Rolle**: [ARIA-Rolle]
- **Tastatur**: [Erwartete Interaktionen]
- **Screenreader**: [Wird angesagt als...]
### Offene Fragen
- [Entscheidung, die ein Design-Review benötigt]
- [Randfall, der gelöst werden muss]
Wenn Konnektoren verfügbar sind
Wenn ~~Designtool verbunden ist:
- Prüfen Sie Komponenten direkt in Figma – überprüfen Sie Namensgebung, Varianten und Token-Nutzung.
- Rufen Sie Komponenteneigenschaften und Layer-Struktur für die Dokumentation ab.
Wenn ~~Wissensdatenbank verbunden ist:
- Suchen Sie nach vorhandener Komponentendokumentation und Nutzungsrichtlinien.
- Veröffentlichen Sie aktualisierte Dokumentation in Ihrem Wiki.
Tipps
- Beginnen Sie mit einer Prüfung – Wissen Sie, wo Sie stehen, bevor Sie entscheiden, wohin Sie gehen.
- Dokumentieren Sie während des Bauens – Es ist einfacher, eine Komponente während des Designs zu dokumentieren.
- Priorisieren Sie Abdeckung vor Perfektion – 80 % der dokumentierten Komponenten ist besser als 100 % von 10 Komponenten.