Was getdesign.md gut macht
Es ist die größte öffentliche Sammlung von DESIGN.md-Dateien, die Installation erfolgt tatsächlich mit einem einzigen Befehl, und parallel zum Katalog wird ein State of DESIGN.md-Bericht veröffentlicht. Wer sehen möchte, auf wie viele verschiedene Arten diese Dateien geschrieben werden, oder gezielt ein Briefing sucht, das von einem bewunderten Produkt abgeleitet ist, findet hier die richtige Anlaufstelle. Es wird vom VoltAgent-Team gepflegt, das auch die awesome-design-md-Liste betreibt.
Der strukturelle Unterschied
Beide Produkte installieren eine DESIGN.md. Die entscheidende Frage ist, was sonst noch im Repository landet, denn ein Design-Briefing ist nur die eine Hälfte eines Designsystems – die Tokens sind die andere.
| getdesign.md | Identity Forge | |
|---|---|---|
| Das schriftliche Briefing | Ja: eine DESIGN.md | Ja: eine DESIGN.md |
| Semantische Farbtokens | Keine Token-Datei. Werte erscheinen als Text innerhalb des Briefings | 28 Rollen, Light und Dark, direkt in das Theme geschrieben |
| Speicherort der Werte | Im Markdown. Das Stylesheet bleibt unverändert | Im Stylesheet. Das Markdown referenziert diese |
| Framework-Exporte | Markdown | CSS-Variablen, Tailwind v3/v4 @theme, shadcn-Registry-Item, DTCG/W3C JSON |
| Ursprung des Designs | Analyse der beobachtbaren Muster eines bestehenden Produkts | Ein originäres Kit oder basierend auf dem eigenen Briefing generiert |
| Agent-Integration | Datei installieren, Agent liest sie aus | MCP-Tools: suchen, Palette abgleichen, Brief lesen, Kit anwenden |
Die zweite und dritte Zeile entscheiden darüber, was tatsächlich in der Codebasis passiert. Wenn die Farbwerte nur in einer Markdown-Datei existieren, liest der Agent diese aus und schreibt sie als Literalwerte in die Komponenten, da es keine andere Referenz gibt. Das Ergebnis ist ein dokumentiertes Design bei einem undokumentierten Stylesheet – genau die Situation, die semantische Tokens verhindern sollen.
Ein Brief, dessen Werte nur im Fließtext stehen und der keine Token-Datei enthält, bietet dem Agenten keine Referenz. Er schreibt Literale, und das Stylesheet lernt nichts dazu.
Dies ist keine Kritik am Format, sondern eine Konsequenz daraus, was ein Katalogeintrag leisten kann. Eine Analyse eines fremden Produkts kann keine Token-Datei liefern, da diese nicht vorliegt.
Was ein aus einer Marke abgeleiteter Brief leisten kann und was nicht
Die Einträge von getdesign.md sind Analysen öffentlich beobachtbarer Muster; die Markenseiten weisen explizit auf die fehlende Affiliation hin. Diese Einordnung ist korrekt und sollte so akzeptiert werden. Die interessante Frage ist, was bei dieser Ableitung erhalten bleibt.
| Übertragbar? | Warum | |
|---|---|---|
| Palette und Schriftfamilie | Ja | Direkt von einer gerenderten Seite beobachtbar |
| Spacing- und Radius-Werte | Meistens | Beobachtbar, wobei die Unterscheidung zwischen systematischen Werten und Einzelfällen eine Interpretationsfrage ist |
| Was das Design bewusst vermeidet | Selten | Abwesenheiten sind durch Beobachtung unsichtbar. Man kann keinen Schatten sehen, der nie verwendet wurde |
| Warum eine Entscheidung getroffen wurde | Nein | Eine Dichte, die einem Power-User den ganzen Tag dient, ist die falsche Antwort für eine Landingpage – und der Brief kann nicht wissen, welche davon vorliegt |
Die dritte Zeile ist die entscheidende, und sie gilt für jeden abgeleiteten Brief, unabhängig vom Ersteller. Wir haben 299 veröffentlichte DESIGN.md-Dateien analysiert und festgestellt, dass 76 % keinerlei Verbote enthalten: zudem spezifizieren 86 % Farben als reine Hex-Werte ohne semantische Rolle und 57 % nennen keine markanten Motive. Verbote sind der Ort, an dem die Identität eines Designs tatsächlich lebt, und genau dort hat eine Outside-In-Analyse den geringsten Zugriff.
Das ist die ehrliche Grenze beim Kopieren des Looks eines bewunderten Produkts, was wir im Linear-Teardown ausführlich behandeln: Die Palette ist der am wenigsten charakteristische Teil des Systems; die Constraints, die es funktionieren lassen, überstehen die Extraktion nicht.
Ein generiertes System, live
Das bedeutet „ein vollständiges System generieren“ in der Praxis: das kostenlose ambient-sage-Kit, gerendert aus seinen echten Tokens und Schriftarten – genau die Payload, die die CLI in das Repo schreibt:
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
npx shadcn add https://identityforge.io/r/ambient-sage.jsonNach diesem Befehl enthält die globals.css 28 benannte Rollen für Light- und Dark-Mode, und die DESIGN.md referenziert diese per Name, statt Hex-Werte zu wiederholen. Diese Kopplung hält den Brief aktuell: Ändern Sie einen Token, und der Brief bleibt korrekt, da er nie eine Kopie des Wertes enthielt.
Welches Tool sollten Sie verwenden?
- Wählen Sie getdesign.md, wenn Sie untersuchen möchten, wie DESIGN.md-Dateien bei verschiedenen Produkten geschrieben werden, oder wenn Sie gezielt einen Brief suchen, der von einem bewunderten Design abgeleitet ist und Sie die Token-Ebene selbst bereitstellen möchten.
- Wählen Sie Identity Forge, wenn Sie ein originäres System als funktionierende Tokens plus passenden Brief wünschen, inklusive MCP-, CLI- und shadcn-Delivery sowie Exporten für Ihren jeweiligen Stack.
- Beide schließen sich nicht aus. Das Lesen von Katalogeinträgen ist ein guter Weg, um zu kalibrieren, wie spezifisch ein Brief sein sollte. Bedenken Sie jedoch, dass ein Brief ohne Tokens das Stylesheet unverändert lässt; kombinieren Sie ihn daher in jedem Fall mit einer echten Token-Ebene.
Egal wofür Sie sich entscheiden, führen Sie danach denselben Check durch: Suchen Sie per grep nach literalen Hex-Werten außerhalb Ihrer Token-Datei. Wenn der Agent diese in Komponenten schreibt, ist der Brief mit nichts verbunden und Sie haben eine Dokumentation statt eines Systems.
Neu bei diesem Format? Beginnen Sie damit, was eine DESIGN.md ist und wie man eine generiert, und wählen Sie dann Ihr Tool aus dem Pillar Guide.
FAQ
Was ist der Unterschied zwischen Identity Forge und getdesign.md?
getdesign.md veröffentlicht DESIGN.md-Analysen bekannter Produkte, die über dessen CLI installiert werden können, ergänzt durch ein LaunchKit-Starter-Kit. Identity Forge generiert ein originäres Designsystem (28 semantische Farbrollen für Light- und Dark-Mode, Schriftarten, Layout-Regeln und Motive) und installiert das Briefing zusammen mit den referenzierten Tokens via MCP, einer CLI oder einer shadcn-Registry.
Liefert getdesign.md Design-Tokens?
Es liefert eine DESIGN.md, die ein Design beschreibt, wobei die Werte direkt im Dokument angegeben sind. Es schreibt keine semantische Token-Datei in das Stylesheet. Dies ist eine logische Konsequenz aus der Natur eines Katalogeintrags: Eine Analyse eines anderen Produkts kann die Token-Datei dieses Produkts nicht ausliefern.
Ist Identity Forge eine Alternative zu getdesign.md?
Um ein installierbares Designsystem zu erhalten: Ja. Um viele ausgearbeitete Beispiele des DESIGN.md-Formats zu durchsuchen, ist getdesign.md die umfangreichere Sammlung; beide erfüllen unterschiedliche Zwecke. Viele Nutzer nutzen einen Katalog zur Orientierung und installieren ein generiertes System, um darauf basierend tatsächlich zu entwickeln.
Kann ich eine DESIGN.md verwenden, die von einer Marke abgeleitet wurde, die mir gefällt?
Das ist möglich und ein guter Weg, um die Anwendung des Formats zu verstehen. Zwei Vorbehalte: Eine Outside-in-Analyse erfasst selten, was ein Design bewusst vermeidet – und genau hier liegt meist die Identität. Zudem sind Design-Entscheidungen vom Zielpublikum abhängig: Eine Informationsdichte, die für ein Tool geeignet ist, das den ganzen Tag genutzt wird, ist die falsche Lösung für eine Seite, die nur vierzig Sekunden lang gescannt wird.
Ist Identity Forge kostenlos?
Kostenlose Kits und die shadcn-Registry funktionieren ohne Konto. Ein API-Key (unter /account/api-keys) wird nur für eigene Daten, ein höheres API-Kontingent und Pro-Kits benötigt.