/design-system
Wenn du unbekannte Platzhalter siehst oder prüfen musst, welche Tools verbunden sind, lies CONNECTORS.md.
Verwalte dein Designsystem – prüfe auf Konsistenz, dokumentiere Komponenten oder entwirf neue Muster.
Verwendung
/design-system audit # Vollständige Systemprüfung
/design-system document [component] # Dokumentiere eine Komponente
/design-system extend [pattern] # Entwirf eine neue Komponente oder ein neues Muster
Bestandteile eines Designsystems
Design-Tokens
Atomare Werte, die die visuelle Sprache definieren:
- Farben (Marken-, semantische, neutrale)
- Typografie (Skala, Schriftgewichte, Zeilenabstände)
- Abstände (Skala, Innenabstände von Komponenten)
- Rahmen (Radius, Breite)
- Schatten (Höhenstufen)
- Bewegung (Dauern, Beschleunigungen)
Komponenten
Wiederverwendbare UI-Elemente mit definierten:
- Varianten (primär, sekundär, ghost)
- 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 Komponenten kombinieren:
- Formulare (Eingabegruppen, Validierung, Absenden)
- Navigation (Sidebar, Tabs, Breadcrumbs)
- Datenanzeige (Tabellen, Karten, Listen)
- Rückmeldungen (Toasts, Modals, Inline-Meldungen)
Prinzipien
- Konsistenz vor Kreativität – Das System existiert, damit Teams nicht das Rad neu erfinden
- Flexibilität innerhalb von Grenzen – Komponenten sollten kombinierbar sein, nicht starr
- Alles dokumentieren – Wenn es nicht dokumentiert ist, existiert es nicht
- Versionierung und Migration – Breaking Changes brauchen Migrationspfade
Ausgabe – Prüfung (Audit)
## Designsystem-Prüfung
### Zusammenfassung
**Geprüfte Komponenten:** [X] | **Gefundene Probleme:** [X] | **Punktzahl:** [X/100]
### Namens-Konsistenz
| Problem | Komponenten | Empfehlung |
|---------|-------------|------------|
| [Inkonsistente Benennung] | [Liste] | [Zu übernehmender Standard] |
### Token-Abdeckung
| Kategorie | Definiert | Gefundene hartcodierte Werte |
|-----------|-----------|------------------------------|
| Farben | [X] | [X] Instanzen von hartcodierten Hex-Werten |
| 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 | Docs | Punktzahl |
|------------|----------|-----------|------|-----------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### Priorisierte Maßnahmen
1. [Wirkungsvollste Verbesserung]
2. [Zweite Priorität]
3. [Dritte Priorität]
Ausgabe – Dokumentation
## Komponente: [Name]
### Beschreibung
[Was diese Komponente ist und wann du sie verwenden solltest]
### Varianten
| Variante | Verwende, wenn |
|----------|----------------|
| [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, Enter, Escape-Verhalten]
- **Screenreader**: [Wird angekündigt als...]
### Do's und Don'ts
| ✅ Tun | ❌ Nicht tun |
|--------|-------------|
| [Beste Praxis] | [Anti-Pattern] |
### Codebeispiel
[Framework-gerechter Code-Ausschnitt]
Ausgabe – Erweiterung
## Neue Komponente: [Name]
### Problem
[Welches Benutzerbedürfnis oder welche Lücke diese Komponente adressiert]
### Bestehende 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 | Verwende, wenn | Visuell |
|----------|----------------|---------|
| [Variante] | [Szenario] | [Beschreibung] |
#### Zustände
| Zustand | Verhalten | Hinweise |
|---------|-----------|---------|
| Standard | [Beschreibung] | — |
| Hover | [Beschreibung] | [Interaktion] |
| Deaktiviert | [Beschreibung] | Nicht interaktiv |
| Laden | [Beschreibung] | [Animation] |
#### Verwendete Tokens
- Farben: [Welche Tokens]
- Abstände: [Welche Tokens]
- Typografie: [Welche Tokens]
### Barrierefreiheit
- **Rolle**: [ARIA-Rolle]
- **Tastatur**: [Erwartete Interaktionen]
- **Screenreader**: [Wird angekündigt als...]
### Offene Fragen
- [Entscheidung, die ein Design-Review benötigt]
- [Grenzfall, der gelöst werden muss]
Wenn Konnektoren verfügbar sind
Falls ~~Designtool verbunden ist:
- Prüfe Komponenten direkt in Figma – überprüfe Benennung, Varianten und Token-Nutzung
- Ziehe Komponenteneigenschaften und Ebenenstruktur für die Dokumentation
Falls ~~Wissensdatenbank verbunden ist:
- Suche nach vorhandener Komponentendokumentation und Nutzungsrichtlinien
- Veröffentliche aktualisierte Dokumentation in deinem Wiki
Tipps
- Beginne mit einer Prüfung – Wisse, wo du stehst, bevor du entscheidest, wohin die Reise geht.
- Dokumentiere während des Bauens – Es ist einfacher, eine Komponente während des Entwurfs zu dokumentieren.
- Priorisiere Abdeckung vor Perfektion – 80 % der Komponenten dokumentiert ist besser als 100 % von 10 Komponenten.