Warum Windsurf ein Design System braucht
Cascade baut Features von Ende zu Ende, aber wie jeder Agent entscheidet er bei jedem Schritt das Styling neu: hier eine leicht andere Akzentfarbe, dort ein neuer Abstand, beim nächsten Screen eine neue Schriftart. Ein Design System nimmt das Raten aus dem Prozess: Ein Satz semantischer Tokens und eine geschriebene DESIGN.md, der Cascade folgt, sorgen dafür, dass die gesamte App wie ein einziges Produkt aussieht und nicht wie zehn verschiedene Prompts.
Windsurf erfordert (aktuell) eine manuelle Installation
Der Befehl identityforge install --client … unterstützt Windsurf noch nicht. Windsurf akzeptiert jedoch dieselbe Standard-MCP-Struktur, also füge den Server wie unten gezeigt manuell hinzu. Die CLI- und shadcn-Pfade funktionieren auch ohne MCP.
Das Kit, das du installieren wirst
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Dashboard
Welcome back — here's how AmbientSage is performing today.
Active users
15.1k
+5%Trending up this month
vs. previous 30 days
MRR
$49.1k
+3%Strong recurring growth
Net of churn
Retention
89%
+2%Engagement above target
Rolling 28-day window
NPS
69
+3Meets growth projections
Survey · n=1,204
Total revenue
Last 12 months
$49.1k+18.2%
Recent sales
You closed 265 deals this month.
Alex Rivera
alex@ambientsage.com
Mira Okonkwo
mira@ambientsage.com
Jonas Feld
jonas@ambientsage.com
Sana Qureshi
sana@ambientsage.com
Theo Lindgren
theo@ambientsage.com
Recent transactions
View all| Customer | Status | Date | Amount |
|---|---|---|---|
AR Alex Rivera Founder & CEO | Paid | 2m ago | $1,999.00 |
MO Mira Okonkwo Head of Product | Pending | 1h ago | $39.00 |
JF Jonas Feld Design Lead | Processing | 3h ago | $299.00 |
SQ Sana Qureshi Engineering Lead | Paid | Yesterday | $99.00 |
TL Theo Lindgren Brand Director | Refunded | 2d ago | $2,400.00 |
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Installation (manuelle MCP-Konfiguration)
- 1
Öffne die Windsurf-MCP-Konfiguration
Öffne in Windsurf Settings → Cascade → MCP servers und wähle die Option, die Rohkonfiguration zu bearbeiten (
~/.codeium/windsurf/mcp_config.json). - 2
Füge den identityforge-Server hinzu
Füge den unten stehenden Eintrag in das
mcpServers-Objekt ein (mergi ihn mit eventuell vorhandenen Servern).{ "mcpServers": { "identityforge": { "command": "npx", "args": ["-y", "identityforge@latest", "mcp"] } } } - 3
MCP-Server aktualisieren
Gehe zurück zum MCP-Panel in Cascade und klicke auf Refresh, damit die identityforge-Tools geladen werden.
- 4
Cascade anweisen, die App zu thematisieren
Gib Produkt, Zielgruppe und Stimmung vor; Cascade nutzt dann
search_themes,get_design_mdundapply_theme.Use Identity Forge to pick a clean, editorial theme for a recipe site, apply it, and follow the DESIGN.md.
Oder überspringe MCP komplett
Da Windsurf Terminal-Befehle ausführen kann, funktionieren die clientunabhängigen Wege auch ohne Konfigurationsänderung: Cascade (oder du) führt einfach einen Befehl aus:
- 1
CLI apply
Schreibt DESIGN.md + eine Tokens-Datei in das aktuelle Verzeichnis. Bitte Cascade, die DESIGN.md zu lesen und die Tokens einzubinden.
identityforge apply ambient-sage - 2
shadcn-Registry
Installiert die CSS-Variablen des Kits direkt für shadcn/ui Projekte.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Der Cursor-Guide beschreibt denselben MCP-Workflow mit einem unterstützten Installationsbefehl, und der Pillar-Guide verknüpft alle Tools. Um die Payload zu verstehen, lies was eine DESIGN.md ist.
FAQ
Wie gebe ich Windsurf ein Design System?
Füge den Identity Forge MCP-Server mit dem Standard-mcpServers-Eintrag (Befehl `npx`, Args `-y identityforge@latest mcp`) zu ~/.codeium/windsurf/mcp_config.json hinzu, aktualisiere die MCP-Server in Cascade und bitte Cascade dann, ein Kit auszuwählen und anzuwenden. Oder überspringe MCP und führe `identityforge apply <slug>` aus.
Gibt es einen `install --client windsurf` Befehl?
Noch nicht. Der Install-Befehl des CLI unterstützt derzeit claude-code, cursor, codex, gemini, vscode, opencode und pi. Windsurf nutzt dieselbe MCP-Struktur, also fügst du die Server-Konfiguration manuell ein.
Kann ich das Bearbeiten von Konfigurationsdateien vermeiden?
Ja. Führe `identityforge apply <slug>` aus, um DESIGN.md und Tokens in das aktuelle Verzeichnis zu schreiben, oder nutze `npx shadcn add https://identityforge.io/r/<slug>.json` für shadcn/ui Projekte. Beides benötigt keine MCP-Konfiguration.