Entscheiden Sie zuerst, welches Artefakt benötigt wird. Ein visuelles Theme ändert Werte wie Farben, Schriftarten, Radien und Schatten. Ein implementierungsfertiges Designsystem verknüpft diese Werte mit semantischen Rollen und Nutzungsregeln. Ein Handoff für Coding-Agents platziert die Regeln und Tokens dort, wo ein Agent sie lesen oder installieren kann. Diese Kategorien überschneiden sich. Sie beschreiben das gelieferte Artefakt, nicht dessen Qualität.
Was die untersuchten Tools liefern
Die untersuchten Tools verwenden ähnliche Bezeichnungen für unterschiedliche Outputs. Das offizielle shadcn/ui bietet anpassbare Open-Code-Komponenten und eine gemeinsame, komponierbare Schnittstelle. Shadcn Design generiert CSS für Light- und Dark-Themes aus einer Primärfarbe. Shadcn Studio ergänzt dies durch einen größeren Theme-Editor mit Steuerelementen, Vorschauen, Presets und Installationspfaden. Identity Forge bündelt semantische Tokens mit schriftlichen Design-Richtlinien und Artefakten für die Übergabe an Agents.
Der Vergleich nutzt vier Evidenzstufen. „Dokumentiert“ bedeutet, dass eine feste Quelle die Funktion belegt. „Teilweise“ bedeutet, dass die Quelle eine eingeschränktere Funktion belegt, wobei die Grenze angegeben ist. „Undokumentiert“ bedeutet, dass die verfügbaren Belege die Funktion nicht belegen, was jedoch kein Beweis für deren Fehlen ist. „Nicht anwendbar“ gilt für Felder, die nicht zum Artefakt passen.
Offizielles shadcn/ui
- Semantische Rollen: undokumentiert. Die zitierten Seiten belegen anpassbare Komponenten und Open Code, aber keinen Output-Kontrakt für semantische Tokens.
- Light- und Dark-Output: undokumentiert. Die Homepage enthält Bilder von Light- und Dark-Interfaces, dokumentiert jedoch nicht den Inhalt eines generierten oder distribuierten Themes.
- Typografie-Steuerung: undokumentiert. Die zitierten Belege belegen keine Typografie-Steuerung als Teil eines Output-Kontrakts.
- Spacing- und Layout-Richtlinien: undokumentiert. Die zitierten Belege belegen keine exportierten Spacing- oder Layout-Regeln.
- Komponenten-Richtlinien: teilweise. Die Quellen dokumentieren anpassbare Open-Code-Komponenten und eine gemeinsame, komponierbare Schnittstelle, aber keine exportierten Design-Nutzungsregeln.
- Vorschauen: teilweise. Die Homepage zeigt repräsentative Interface-Oberflächen, aber die Belege belegen keinen interaktiven Theme- oder Export-Vorschau-Workflow.
- Export- oder Lieferform: dokumentiert. Die Dokumentation beschreibt Open-Component-Code, der über ein Flat-File-Schema und CLI distribuiert wird.
- Registry-Lieferung: undokumentiert. Die zitierten Auszüge belegen diesen Lieferweg nicht.
- Agent-lesbare Dokumentation: teilweise. Die Einleitung besagt, dass AI-Modelle den Open Code und die konsistente API lesen können, belegt jedoch kein separates Dokument für Design-Regeln.
Shadcn Design
- Semantische Rollen: undokumentiert. Die Seite dokumentiert generierte CSS-Variablen, legt jedoch nicht genügend vom Output offen, um einen bedeutungsbasierten Rollensatz zu verifizieren.
- Light- und Dark-Output: dokumentiert. Der Generator gibt an, dass beide Modi aus einer Primärfarbe erstellt werden.
- Typografie-Steuerung: dokumentiert. Die Seite bietet separate Auswahlmöglichkeiten für Fließtext- und Überschriften-Schriftarten.
- Spacing- und Layout-Richtlinien: undokumentiert. Die Seite belegt keine schriftlichen Spacing- oder Layout-Regeln.
- Komponenten-Richtlinien: undokumentiert. Gestylte Vorschau-Screens belegen keine exportierten Anweisungen zur Komponenten-Nutzung.
- Vorschauen: dokumentiert. Der Generator bietet Live-Vorschauen für Landingpages, Dashboards und Charts.
- Export- oder Lieferform: dokumentiert. Es werden Tailwind v4 CSS-Variablen kopiert, die Farben, Schriftarten, Radien und Schatten abdecken.
- Registry-Lieferung: undokumentiert. Die zitierte Seite belegt keine Registry-Installation für das generierte Theme.
- Agent-lesbare Dokumentation: undokumentiert. Die Belege belegen kein Design-Briefing oder ein anderes Regeldokument, das mit dem Theme geliefert wird.
Shadcn Studio
- Semantische Rollen: teilweise. Der Generator dokumentiert benannte Steuerelemente, einschließlich primary und destructive, aber die Belege belegen kein vollständiges Inventar semantischer Rollen.
- Light- und Dark-Output: dokumentiert. Der Generator dokumentiert die Anpassung und den Export von shadcn Themes innerhalb seines Theme-Workflows.
- Typografie-Steuerung: dokumentiert. Die Dokumentation enthält einen Tab für Typografie.
- Spacing- und Layout-Richtlinien: undokumentiert. Die zitierten Seiten belegen keine exportierten Spacing- oder Layout-Regeln.
- Komponenten-Richtlinien: undokumentiert. Echtzeit-Vorschauen zeigen visuelle Effekte, aber die Belege belegen keine schriftlichen Komponenten-Nutzungsregeln im Export.
- Vorschauen: dokumentiert. Der Generator bietet Echtzeit-Vorschauen für Komponenten, Blöcke und Templates.
- Export- oder Lieferform: dokumentiert. Die Quellen beschreiben kopierte Ausgaben, manuelle Einrichtung und eine Registry-Route.
- Registry-Lieferung: dokumentiert. Die Dokumentation führt die Registry-Installation als Pro-Option und die manuelle Einrichtung als alternative Route auf.
- Agenten-lesbare Dokumentation: nicht dokumentiert. Die KI-gestützte Theme-Generierung ist dokumentiert, dies unterscheidet sich jedoch vom Export von Regeln für einen anderen Coding-Agenten.
Identity Forge
- Semantische Rollen: dokumentiert. Identity Forge dokumentiert 28 bedeutungsbasierte Farenrollen für beide Modi sowie CSS-, Tailwind- und DTCG-Exporte.
- Light- und Dark-Output: dokumentiert. Der Leitfaden für semantische Token und Belege aus öffentlichen Kits beschreiben separate Light- und Dark-Werte.
- Typografie-Steuerungen: dokumentiert. Daten aus öffentlichen Kits enthalten Typografie-Rollen, Schriftfamilien, Schriftschnitte und eine Skalenbezeichnung.
- Spacing- und Layout-Richtlinien: dokumentiert. Der DESIGN.md-Leitfaden gibt an, dass die generierten Briefings Spacing- und Layout-Regeln enthalten.
- Komponenten-Richtlinien: dokumentiert. Der DESIGN.md-Leitfaden beschreibt die Behandlung von Komponenten und explizite Nutzungsbeschränkungen im schriftlichen Briefing.
- Vorschauen: dokumentiert. Seiten öffentlicher Kits zeigen Kits auf repräsentativen Interface-Oberflächen.
- Export- oder Lieferform: dokumentiert. Die Produktquellen beschreiben DESIGN.md sowie CSS-, Tailwind-, shadcn- und DTCG-Token-Formate.
- Registry-Lieferung: dokumentiert. First-Party-Leitfäden dokumentieren die shadcn-Registry-Installation neben CLI- und MCP-Routen.
- Agenten-lesbare Dokumentation: dokumentiert. DESIGN.md liefert schriftliche Richtlinien, die an die Kit-Token gebunden sind.
Es gibt in dieser Übersicht keinen universellen Gewinner. Ein spezialisierter Generator ist die bessere Wahl, wenn ein bestehendes shadcn-Projekt lediglich neue visuelle Variablen und eine Vorschau benötigt. Umfassendere Regeln werden dann nützlich, wenn Entwickler oder Agenten neue Interface-Entscheidungen treffen müssen, ohne wiederholt das beabsichtigte System erraten zu müssen.
Export prüfen vor der Auswahl
Wenden Sie dieses Arbeitsblatt auf einen tatsächlichen Export an. Es handelt sich um eine vom Leser durchgeführte Inspektion, nicht um ein Benchmark der oben genannten Tools. Verwenden Sie für jeden Kandidaten denselben Beispielinhalt, damit die Unterschiede aus den Artefakten resultieren und nicht aus verschiedenen Testbildschirmen.
1. Token-Bedeutung und Modus-Parität
- Testinhalt: Seitenhintergrund, Standard- und gedämpfter Text, primäre und destruktive Aktionen, ein Eingabefeld mit Rahmen, ein ausgewähltes Steuerelement und ein Tastatur-Fokus-Zustand.
- Prüfung: Protokollieren Sie, ob die Namen den Zweck beschreiben (z. B. background, foreground, primary, destructive, border und ring) oder nur visuelle Werte. Ordnen Sie jeder geprüften Light-Rolle ihr Dark-Gegenstück zu.
- Fehlerbedingung: Eine Komponente benötigt einen rohen Farbton, weil keine geeignete Rolle existiert, eine Light-Rolle hat kein Dark-Gegenstück oder destruktive Zustände und Fokus-Zustände leihen sich eine nicht zusammengehörige Rolle aus.
2. Repräsentative Komponenten-Oberflächen
- Testinhalt: primäre und sekundäre Buttons, deaktivierte Eingabefelder und Fehler-Eingabefelder, Cards, Popover, Navigation, eine Tabelle mit ausgewählten Zeilen und Hover-Zeilen sowie ein Diagramm mit mehreren Datenreihen.
- Prüfung: Verfolgen Sie sichtbare Farben zurück zu den exportierten Rollen. Prüfen Sie Vordergrund- und Hintergrund-Paare, Rahmen, Fokus-Indikatoren, Overlays, ausgewählte Zustände und Rollen für Diagramm-Datenreihen.
- Fehlerbedingung: Der Bildschirm erfordert improvisierte Werte, eine Rolle dient widersprüchlichen Zwecken oder ein Zustand wird in einem Modus nicht mehr unterscheidbar. Protokollieren Sie dies als Lücke im Kandidaten-Export, nicht als Beweis für die generellen Fähigkeiten des Tools.
3. Typografie-Rollen
- Testinhalt: Seitentitel, Abschnittsüberschrift, Fließtext, Formularbeschriftung, Hilfetext, Tabellenwerte und ein Code- oder Identifikatorfeld, sofern relevant.
- Prüfung: Notieren Sie, ob das Artefakt Schriftfamilien, Schriftschnitte, Größen, Zeilenhöhen und Laufweiten auf benannte Rollen abbildet oder nur Schriftfamilien-Werte liefert.
- Fehlerbedingung: Implementierer müssen Schriftschnitte oder Behandlungen erfinden, eine Rolle bezieht sich auf einen nicht verfügbaren Schriftschnitt oder die exportierten Werte widersprechen den schriftlichen Anweisungen.
4. Spacing, Layout und beibehaltene Richtlinien
- Testinhalt: schmales Formular, Card-Grid, dichte Tabelle, Seitenkopf und responsive Navigation.
- Prüfung: Suchen Sie nach Regeln für Inhaltsbreite, Abstände (Gutters), Abschnittsabstände, Komponentendichte, Grid-Verhalten und responsive Änderungen. Prüfen Sie, ob diese Regeln nach dem Export oder der Installation verfügbar bleiben.
- Fehlerbedingung: Eine Vorschau impliziert ein Layout, das das Artefakt nie beschreibt, der Export lässt die schriftlichen Regeln weg oder ein anderer Implementierer muss Dichte und Struktur allein aus Bildern ableiten.
Den Handoff-Vertrag prüfen
Ein Coding-Agent kann nur die Richtlinien nutzen, die seinen Arbeitskontext erreichen. Bevor Sie einen Export als Agenten-Handoff bezeichnen, beantworten Sie diese Fragen für das tatsächliche Artefakt und das Projekt.
- Framework-Annahmen: Welchen shadcn-, Tailwind-, Framework- oder Komponentenbibliotheks-Kontext wird erwartet? Notieren Sie Versionen, sofern die Quelle diese angibt.
- Installationsroute: Erhält das Projekt kopiertes CSS, Komponenten-Code, ein per CLI angewendetes Bundle, einen Registry-Eintrag, ein per MCP geliefertes Artefakt oder eine Kombination daraus?
- Token-zu-Komponenten-Mapping: Kann der Implementierer die Rollen für Buttons, Eingabefelder, Cards, Popover, Navigation, Tabellen, Diagramme, destruktive Aktionen und Fokus-Zustände identifizieren?
- Typografie-Entscheidungen: Sind die zulässigen Schriftfamilien, Rollen und verfügbaren Schriftschnitte explizit angegeben?
- Spacing- und Layout-Regeln: Beschreibt der Handoff die Anordnung von Seiten und Komponenten oder nur Theme-Werte?
- Nutzungsbeschränkungen: Wird erklärt, wann eine bestimmte Behandlung verwendet werden sollte oder nicht?
- Bekannte Lücken: Welche Werte oder Regeln erfordern noch eine Entscheidung durch einen Designer, Entwickler oder Agenten?
Eine DESIGN.md hilft nur, wenn der Workflow sie dort platziert, wo der Ziel-Agent sie liest. Ein Registry-Eintrag kann Werte installieren, ohne notwendigerweise die schriftliche Begründung in denselben Kontext zu bringen. Prüfen Sie beide Pfade, anstatt davon auszugehen, dass ein installiertes Artefakt die vollständige Übergabe enthält.
Praxisbeispiel: Ambient Sage
Das öffentliche Ambient Sage Kit ist ein begrenztes Beispiel für eine umfassendere Übergabe. Die veröffentlichten Daten listen 28 semantische Color-Tokens für Light- und Dark-Modes auf. Die Seite stellt zudem eine DESIGN.md bereit und identifiziert Installationspfade, einschließlich der Identity Forge CLI und der shadcn Registry. Dies sind beobachtete Eigenschaften dieses Kits und kein Beleg dafür, dass seine visuellen Entscheidungen für jedes Produkt geeignet sind.
Die veröffentlichte Typografie weist Plus Jakarta Sans den Rollen für Überschriften und Fließtext in den Schritten 400, 500, 600 und 700 zu. JetBrains Mono übernimmt die Mono-Rolle in den Schritten 400, 500 und 700. Die Skalenbezeichnung ist compact-product. Die Quellen des Font-Projekts belegen, dass die genannten Schriftfamilien existieren, zeigen jedoch nicht, dass diese Kombination, dieser Schriftschnitt-Satz oder diese Skala für jede Implementierung vorzuziehen ist.
Die öffentlichen Belege identifizieren das Artefakt und dessen angegebenen Umfang. Die Übernahme erfordert dennoch eine Prüfung. Prüfen Sie, ob der gewählte Export alle 28 Rollen in beiden Modi beibehält, ob das Projekt die gelisteten Schriftschnitte lädt und ob die DESIGN.md die Person oder den Agenten erreicht, von dem die Befolgung erwartet wird. Verfolgen Sie anschließend die Rollen über die Komponenten des Arbeitsblatts. Dieser Artikel enthält keinen vergleichenden Benchmark.
Das kleinste ausreichende Tool wählen
- Wählen Sie kopiertes CSS, wenn die Aufgabe ein visuelles Refresh ist und das Projekt bereits über Regeln für Komponenten, Typografie, Spacing und Layout verfügt.
- Wählen Sie einen Theme-Editor oder ein wiederverwendbares Preset, wenn shadcn-Projekte konsistente visuelle Variablen und Previews benötigen, während umfassendere Produktrichtlinien an anderer Stelle existieren.
- Wählen Sie ein implementierungsbereites Designsystem, wenn die Implementierer gemeinsame semantische Rollen sowie explizite Richtlinien für Typografie, Spacing, Layout und Komponenten benötigen.
- Wählen Sie eine Agent-Übergabe, wenn ein AI-Builder diese Entscheidungen während der Implementierung beibehalten muss. Überprüfen Sie, wie sowohl Tokens als auch schriftliche Regeln in dessen Kontext gelangen.
Nehmen Sie einen Beispiel-Export und lassen Sie ihn durch das Arbeitsblatt laufen, bevor Sie ihn zum Projekt hinzufügen. Die ungelösten Entscheidungen zeigen, ob das aktuelle Artefakt ausreichend ist oder ob die Arbeit eine umfassendere Übergabe erfordert.
Quellen
- Die Basis für Ihr Designsystem - shadcn/ui: Zeigt anpassbare Open-Code-Komponenten sowie repräsentative Light- und Dark-Interface-Oberflächen.
- Einführung - shadcn/ui: Dokumentiert Open Code, Komposition, Flat-File-Schema und CLI-Distribution sowie eine für AI-Tools lesbare API.
- Shadcn Theme Generator | Live Preview, Copy Theme CSS: Dokumentiert die Generierung aus einer Primärfarbe, Light- und Dark-Themes, Font-Steuerungen, Radius-Presets, Live-Previews und Tailwind v4 CSS-Variablen-Output.
- Design Stunning UIs Faster with Shadcn Theme Generator: Dokumentiert Presets, Echtzeit-Anpassung, Typografie-Steuerungen, benannte Farbstuerungen, Kontrastvalidierung, Previews sowie Theme-Import und -Export.
- Shadcn Theme Generator Documentation: Dokumentiert Theme-Steuerungen, das Kopieren des Outputs, die manuelle Einrichtung und die Pro-Registry-Installation.
- Identity Forge: Dokumentiert Kits, die Fonts, semantische Tokens, Spacing, DESIGN.md-Richtlinien, Previews und Agent-Delivery-Pfade enthalten.
- Ambient Sage Design Kit: Liefert öffentliche Belege für die semantischen Tokens, Typografie-Rollen und -schnitte, die compact-product-Skalenbezeichnung, die DESIGN.md, Exporte und Installationsziele des Praxisbeispiels.
- Semantische Color-Tokens erklärt: Dokumentiert die 28 semantischen Light- und Dark-Rollen von Identity Forge sowie die Exportformate für CSS, Tailwind und DTCG.
- Wie man eine DESIGN.md generiert (und was sie ist): Dokumentiert den Umfang einer DESIGN.md, einschließlich Design-Intention, Token-Referenzen, Typografie, Spacing, Layout, Komponenten-Behandlungen, Motiven und Nutzungsbeschränkungen.
- Designsysteme für AI Coding-Agenten: Dokumentiert die Bereitstellung von Tokens und DESIGN.md über MCP-, CLI- und shadcn-Registry-Routen.
- Plus Jakarta Sans: Stellt die Projektquelle für die im Ambient Sage Beispiel genannte Plus Jakarta Sans Familie bereit.
- JetBrains Mono: Stellt die Projektquelle für die im Ambient Sage Beispiel genannte JetBrains Mono Familie bereit.
Quellen
- The Foundation for your Design System - shadcn/ui: Zeigt anpassbare Open-Code-Komponenten sowie repräsentative Light- und Dark-Interface-Oberflächen.
- Introduction - shadcn/ui: Dokumentiert Open Code, Komposition, Flat-File-Schema und CLI-Distribution sowie eine für AI-Tools lesbare API.
- Shadcn Theme Generator | Live Preview, Copy Theme CSS: Dokumentiert die Generierung aus einer Primärfarbe, Light- und Dark-Themes, Font-Steuerungen, Radius-Presets, Live-Previews und Tailwind v4 CSS-Variablen-Output.
- Design Stunning UIs Faster with Shadcn Theme Generator: Dokumentiert Presets, Echtzeit-Anpassung, Typografie-Steuerungen, benannte Farbstuerungen, Kontrastvalidierung, Previews sowie Theme-Import und -Export.
- Shadcn Theme Generator Documentation: Dokumentiert Theme-Steuerungen, das Kopieren des Outputs, die manuelle Einrichtung und die Pro-Registry-Installation.
- Identity Forge: Dokumentiert Kits, die Fonts, semantische Tokens, Spacing, DESIGN.md-Richtlinien, Previews und Agent-Delivery-Pfade enthalten.
- Ambient Sage Design Kit: Liefert öffentliche Belege für die semantischen Tokens, Typografie-Rollen und -schnitte, die compact-product-Skalenbezeichnung, die DESIGN.md, Exporte und Installationsziele des Praxisbeispiels.
- Semantic color tokens explained: Dokumentiert die 28 semantischen Light- und Dark-Rollen von Identity Forge sowie die Exportformate für CSS, Tailwind und DTCG.
- How to generate a DESIGN.md (and what it is): Dokumentiert den Umfang einer DESIGN.md, einschließlich Design-Intention, Token-Referenzen, Typografie, Spacing, Layout, Komponenten-Behandlungen, Motiven und Nutzungsbeschränkungen.
- Design systems for AI coding agents: Dokumentiert die Bereitstellung von Tokens und DESIGN.md über MCP-, CLI- und shadcn-Registry-Routen.
- Plus Jakarta Sans: Stellt die Projektquelle für die im Ambient Sage Beispiel genannte Plus Jakarta Sans Familie bereit.
- JetBrains Mono: Stellt die Projektquelle für die im Ambient Sage Beispiel genannte JetBrains Mono Familie bereit.