Designesy

Avalie qualquer URL contra um contrato de design system com 40 verificações — tokens, motion, acessibilidade, cadência, tipografia. Nota de A a F, integração SARIF com CI.

GitHubExperimente este MCPPatrocinado

Documentação

Designesy

designesy.org — verificação de contrato de design system, pontuação e ferramentas de revisão para agentes de IA.

Início Rápido

Pontue qualquer URL em 5 segundos — sem instalação:

npx designesy-score@latest https://your-site.com

Adicione ao Claude Desktop, Cursor ou qualquer cliente MCP:

# Remote (zero install, no auth):
claude mcp add designesy --transport http https://www.designesy.org/api/mcp

# Or local stdio via PyPI:
pip install designesy-mcp && designesy-mcp

Quer clonar este repositório? O .mcp.json na raiz registra automaticamente o servidor no Cursor e no Claude Code — basta abrir o projeto.

Controle seu CI com conformidade ao contrato de design:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: B
    post-comment: true   # posts a summary comment on PRs (default)

O mesmo mecanismo de 40 verificações alimenta um servidor MCP (17 ferramentas para agentes de IA), uma CLI sem dependências (npx designesy-score), uma GitHub Action e um ranking ao vivo em designesy.org/leaderboard.

Designesy Contract Check é uma GitHub Action que pontua qualquer URL contra um contrato de design system com 40 verificações — tokens, movimento, acessibilidade, cadência, takt, equilíbrio, identidade, interação, desempenho, responsividade, semântica, segurança, especificação, redação — e reprova seu fluxo de CI quando a pontuação ou a nota cai abaixo do seu limite. Sem LLM, sem heurísticas, sem achismo: cada verificação é determinística, reproduzível e fundamentada em um contrato publicado.

Ferramentas

designesy_score — Pontua uma URL ao vivo contra o contrato de design de 40 verificações. Retorna pontuação, nota (A–F) e detalhamento por verificação.
designesy_tokens_score — Valida um arquivo de design tokens DTCG. 10 verificações de conformidade com W3C DTCG 2025.10.
designesy_a11y_score — Obtém o framework de acessibilidade WCAG 2.2 AA e o modelo de script Playwright/axe-core.
designesy_motion_score — Valida um arquivo de animação Lottie. 10 verificações contra a especificação Lottie v1.0.1 e os padrões de movimento §16.
designesy_contract — Obtém o contrato de design system (tokens, movimento, takt, cadência, tipografia, verificação).
designesy_catalog — Lista os 12 pacotes Designesy publicados com versões e URLs.
designesy_design_review — Obtém a rubrica de revisão qualitativa de design em 8 dimensões.
designesy_skill_md — Obtém o contrato no formato SKILL.md para agentes (para Cursor, Claude Code ou Replit).
designesy_agent_json — Obtém o documento de descoberta /.well-known/agent.json.
designesy_llms_txt — Obtém o resumo curto para agentes /llms.txt.
designesy_llms_full_txt — Obtém o resumo completo para agentes /llms-full.txt com prompt pronto para colar.

Tabela de referência das ferramentas

Ferramenta	Descrição
`designesy_score`	Pontua uma URL ao vivo contra o contrato de design de 40 verificações — retorna pontuação, nota (A–F) e detalhamento por verificação
`designesy_tokens_score`	Valida um arquivo de design tokens DTCG (10 verificações de conformidade, W3C DTCG 2025.10)
`designesy_a11y_score`	Obtém o framework de acessibilidade WCAG 2.2 AA + modelo de script Playwright/axe-core
`designesy_motion_score`	Valida um arquivo de animação Lottie (10 verificações, especificação Lottie v1.0.1 + padrões de movimento §16)
`designesy_contract`	Obtém o contrato de design system (tokens, movimento, takt, cadência, tipografia, verificação)
`designesy_catalog`	Lista os 12 pacotes Designesy publicados com versões e URLs
`designesy_design_review`	Obtém a rubrica de revisão qualitativa de design em 8 dimensões
`designesy_skill_md`	Obtém o contrato no formato SKILL.md para agentes (para Cursor/Claude Code/Replit)
`designesy_agent_json`	Obtém o documento de descoberta /.well-known/agent.json
`designesy_llms_txt`	Obtém o resumo curto para agentes /llms.txt
`designesy_llms_full_txt`	Obtém o resumo completo para agentes /llms-full.txt com prompt pronto para colar

Ao vivo

Site: designesy.org
Endpoint MCP: designesy.org/api/mcp (Streamable HTTP, sem autenticação)
Pontue um site: designesy.org/score
Ranking: designesy.org/leaderboard — 30 sites pontuados
Metodologia: designesy.org/methodology — metodologia completa de pontuação com 40 verificações
Contrato: designesy.org/contracts/design-system
Exportação para máquina: designesy.org/contracts/design-system.json

Verificação do contrato

O site ao vivo é verificado contra o contrato de design system — 40 verificações determinísticas com proveniência até os tokens. Pontuação atual: 95,3% (Nota A) — 33 aprovadas, 0 reprovadas, 3 com aviso, 1 ignorada, 3 manuais (verificações apenas no navegador). Consulte a página de metodologia para saber como a pontuação é calculada.

Contrato v0.4.0

40 verificações em 14 categorias ponderadas — tokens, movimento, acessibilidade, cadência, takt, equilíbrio, identidade, interação, desempenho, responsividade, semântica, segurança, especificação, redação
Princípios de redação (v0.4.0) — 16 princípios de redação UX + 4 verificações (frases verbais em botões, sem pontos finais, texto descritivo em links, sem CAIXA ALTA)
10 Padrões de Movimento Inegociáveis — easing deliberado, propriedades explícitas, entradas com opacidade, imobilidade no teclado, sem animação de layout, bloqueio por toque, duração limitada, caminhos com movimento reduzido, pressionamento assimétrico, sem ease-in
10 pistas acústicas — $type: sound personalizado (novo vs. W3C DTCG 2025.10), mecanismo Cuelume v0.1.0, apenas interação
9 tensões em aberto — documentadas, não ocultas
Física de mola — tokens padrão e de momentum via $type: spring personalizado
Legível por máquina — formato W3C DTCG 2025.10 + extensões personalizadas

Consulte a página do contrato para o histórico completo de adoção.

GitHub Action

Controle seu CI com conformidade ao contrato de design:

- uses: LE-VAI/designesy-org@v1
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: C
    post-comment: true   # posts a summary comment on PRs (default)

Pontua uma URL via mecanismo /api/score ao vivo e reprova o fluxo de trabalho se a pontuação ou a nota cair abaixo do seu limite. Executa em node24, publica comentários em PRs via API REST do GitHub (zero dependências). Consulte action/README.md para uso completo.

CLI

Pontue uma URL pela linha de comando — para desenvolvimento local, hooks de pre-commit ou scripts:

# Local (no install needed):
node cli/designesy-score.mjs designesy.org

# With gating (exit 1 on failure):
node cli/designesy-score.mjs linear.app --min-score 70 --min-grade B

# JSON output for piping:
node cli/designesy-score.mjs vercel.com --format canonical --json

# Via npm script:
npm run score -- designesy.org

Zero dependências — apenas recursos nativos do Node. A flag --api ou a variável de ambiente SCORE_API substitui a URL do mecanismo de pontuação (padrão: https://www.designesy.org). Consulte --help para todas as opções.

Repositório

Este é o raiz público controlado do Designesy — um site Next.js 15 App Router (React 19, Turbopack, deploy na Vercel).

apps/site          Next.js application
action/            designesy/contract-check GitHub Action
cli/               designesy-score CLI
docs/designesy     context, architecture, logs, registries
DESIGN.md          the design contract (human-readable)
AGENTS.md          agent operating rules

O que Designesy não é

Designesy não é uma galeria de templates. Designesy não é uma ferramenta genérica de design com IA. Designesy não é um moodboard.

Designesy é um sistema.

Ferramentas relacionadas

Lyse — pontuação de saúde de design system com 258 verificações a partir do seu código (6 eixos). Designesy pontua qualquer URL pública; Lyse pontua seu repositório. Complementares.
DSAF — auditoria de maturidade de design system assistida por LLM com 125 critérios em 20 categorias. Designesy é pontuação determinística de URL; DSAF é avaliação de maturidade assistida por LLM. Camadas diferentes, mesmo objetivo.
axe-core — testes de acessibilidade WCAG. Designesy verifica conformidade com o contrato de design (tokens, movimento, tipografia) — uma camada diferente. Eles se complementam.
Lighthouse — auditoria de desempenho, acessibilidade e SEO. Designesy verifica conformidade com o contrato de design — Lighthouse não sabe o que é um design token.

FAQ

Precisa de chave de API? Não — todas as 17 ferramentas são somente leitura. O endpoint MCP é Streamable HTTP sem estado e sem autenticação.

É determinístico? Sim. Não há LLM no loop de pontuação — cada verificação é determinística e reproduzível. A mesma URL sempre produzirá a mesma pontuação.

Contra o que ele pontua? Contra o contrato de design system Designesy v0.4.0 — 40 verificações em 14 categorias ponderadas (tokens, movimento, acessibilidade, cadência, takt, equilíbrio, identidade, interação, desempenho, responsividade, semântica, segurança, especificação, redação).

Posso usar em CI? Sim. A GitHub Action controla seu fluxo de trabalho com base na conformidade com o contrato — reprove o build se a pontuação cair abaixo do seu limite.

Onde o contrato é publicado? Em designesy.org/contracts/design-system (legível por humanos) e designesy.org/contracts/design-system.json (legível por máquina, W3C DTCG 2025.10).

Licença

MIT — consulte LICENSE. O contrato é público; o código é open-source sob MIT.