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

_{Um loop de 12 segundos, gravado a partir da página inicial. Ele é reproduzido uma vez e pausa no veredito, mostrando um quadro estático se você preferir movimento reduzido. Veja em execução em designesy.org.}

designesy.org — ferramentas de verificação de contrato de design system, pontuação e 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

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

Bloqueie seu CI em conformidade com o 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 42 verificações alimenta um servidor MCP (17 ferramentas para agentes de IA), um 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 de 42 verificações — tokens, motion, acessibilidade, cadência, takt, equilíbrio, identidade, interação, performance, responsividade, semântica, segurança, especificação, copywriting — e falha seu workflow de CI quando a pontuação ou a nota cai abaixo do seu limite. Sem LLM, sem heurísticas, sem "vibe-tax": 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 42 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 motion §16.
designesy_contract — Obtém o contrato do design system (tokens, motion, takt, cadência, tipografia, verificação).
designesy_catalog — Lista os pacotes Designesy publicados com versões e URLs (a contagem retorna em package_count).
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 (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 42 verificações — retorna pontuação, nota (A–F), 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 motion §16)
`designesy_contract`	Obtém o contrato do design system (tokens, motion, takt, cadência, tipografia, verificação)
`designesy_catalog`	Lista os 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 (HTTP Streamable, 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 42 verificações
Contrato: designesy.org/contracts/design-system
Exportação de máquina: designesy.org/contracts/design-system.json

Verificação do contrato

O site ao vivo é verificado contra o contrato do design system — 40 verificações determinísticas com proveniência de volta aos tokens. Pontuação atual: 93% (Nota A) — 36 aprovadas, 0 reprovadas, 0 com aviso, 1 ignorada, 3 manuais (verificações apenas no navegador; a ignorada é DESIGN.md ainda não servido na raiz do site — veja /contracts/design-system). Veja a página de metodologia para saber como a pontuação é calculada.

Contrato v0.4.0

40 verificações em 14 categorias ponderadas — tokens, motion, acessibilidade, cadência, takt, equilíbrio, identidade, interação, performance, responsividade, semântica, segurança, especificação, copywriting
Princípios de copywriting (v0.4.0) — 16 princípios de UX copy + 4 verificações (frases verbais em botões, sem pontos finais, texto de link descritivo, sem CAIXA ALTA)
10 Padrões de Motion Inegociáveis — easing deliberado, propriedades explícitas, entradas com opacidade, imobilidade no teclado, sem animação de layout, gating por toque, duração limitada, caminhos de 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 abertas — documentadas, não ocultas
Física de mola — tokens padrão + momentum via $type: spring personalizado
Legível por máquina — formato W3C DTCG 2025.10 + extensões personalizadas

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

GitHub Action

Bloqueie seu CI em conformidade com o 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 falha o workflow 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). Veja 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 built-ins 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). Veja --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, motion, tipografia) — uma camada diferente. Eles se complementam.
Lighthouse — auditoria de performance, acessibilidade e SEO. Designesy verifica conformidade com o contrato de design — Lighthouse não sabe o que é um design token.

FAQ

Precisa de uma chave de API? Não — todas as 17 ferramentas são somente leitura. O endpoint MCP é HTTP Streamable 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? O contrato de design system Designesy v0.4.0 — 42 verificações em 14 categorias ponderadas (tokens, motion, acessibilidade, cadência, takt, equilíbrio, identidade, interação, performance, responsividade, semântica, segurança, especificação, copywriting).

Posso usar em CI? Sim. A GitHub Action bloqueia seu workflow em conformidade com o contrato — falha 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 — veja LICENSE. O contrato é público; o código é open-source sob MIT.