Por que o Windsurf precisa de um design system
O Cascade constrói funcionalidades de ponta a ponta, mas como todo agente, ele redefine a estilização a cada turno: uma cor de destaque ligeiramente diferente aqui, um espaçamento novo ali, uma fonte nova na próxima tela. Um design system elimina as suposições: um conjunto de tokens semânticos e um DESIGN.md escrito que o Cascade segue, para que todo o aplicativo pareça um único produto em vez de dez prompts diferentes.
O Windsurf requer instalação manual (por enquanto)
O comando identityforge install --client … ainda não suporta o Windsurf. O Windsurf aceita o mesmo formato padrão de MCP, então adicione o servidor manualmente como mostrado abaixo. Os caminhos via CLI e shadcn funcionam sem o MCP.
O kit que você vai instalar
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
Instale-o (configuração manual de MCP)
- 1
Abra a configuração de MCP do Windsurf
No Windsurf, abra Settings → Cascade → MCP servers e escolha editar a configuração bruta (
~/.codeium/windsurf/mcp_config.json). - 2
Adicione o servidor identityforge
Cole a entrada abaixo no objeto
mcpServers(mescle-a com quaisquer servidores existentes).{ "mcpServers": { "identityforge": { "command": "npx", "args": ["-y", "identityforge@latest", "mcp"] } } } - 3
Atualize os servidores MCP
De volta ao painel de MCP do Cascade, atualize para que as ferramentas do identityforge sejam carregadas.
- 4
Peça ao Cascade para tematizar o app
Forneça o produto, o público e o clima; ele usará
search_themes,get_design_mdeapply_theme.Use Identity Forge to pick a clean, editorial theme for a recipe site, apply it, and follow the DESIGN.md.
Ou pule o MCP inteiramente
Como o Windsurf pode executar comandos de terminal, os caminhos agnósticos de cliente funcionam sem qualquer edição de configuração: o Cascade (ou você) apenas executa um comando:
- 1
Aplicação via CLI
Escreve o DESIGN.md + um arquivo de tokens no diretório atual. Peça ao Cascade para ler o DESIGN.md e conectar os tokens.
identityforge apply ambient-sage - 2
Registro shadcn
Instala as variáveis CSS do kit diretamente para projetos shadcn/ui.
npx shadcn add https://identityforge.io/r/ambient-sage.json
O guia do Cursor cobre o mesmo fluxo de MCP com um comando de instalação suportado, e o guia principal conecta todas as ferramentas. Para entender o conteúdo enviado, leia o que é um DESIGN.md.
FAQ
Como eu dou um design system ao Windsurf?
Adicione o servidor MCP Identity Forge ao ~/.codeium/windsurf/mcp_config.json usando a entrada mcpServers padrão (comando `npx`, args `-y identityforge@latest mcp`), atualize os servidores MCP do Cascade e, em seguida, peça ao Cascade para escolher e aplicar um kit. Ou pule o MCP e execute `identityforge apply <slug>`.
Existe um comando install --client windsurf?
Ainda não. O comando de instalação da CLI suporta atualmente claude-code, cursor, codex, gemini, vscode, opencode e pi. O Windsurf usa o mesmo formato de MCP, então você cola a configuração do servidor manualmente.
Posso evitar editar arquivos de configuração?
Sim. Execute `identityforge apply <slug>` para escrever o DESIGN.md e os tokens no diretório atual, ou `npx shadcn add https://identityforge.io/r/<slug>.json` para projetos shadcn/ui. Nenhum dos dois precisa de uma configuração de MCP.