convez.ai
SkillDesign & UIIntermediário
kylesnav

Delightful Design System para Claude Code

kylesnav/delightful-claude-plugin

Sistema de design completo com tokens, componentes e auditoria para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que integra o Delightful Design System — um sistema de design neo-brutalista com tokens OKLCH, componentes prontos e auditoria automática — diretamente no Claude Code. Inclui skills para construir, refatorar e auditar UI, agentes especializados e exportação de temas em CSS, Tailwind e Figma.

Instalação

$npx convez-ai kylesnav/delightful-claude-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Construir interfaces consistentes com design system neo-brutalista
  • Refatorar UI existente para aderir ao design system automaticamente
  • Auditar CSS e HTML quanto a violações de padrão de design
  • Gerar apresentações interativas com temas customizáveis
  • Exportar tokens para CSS, Tailwind ou Figma

Veredito

Ferramenta sólida para times que usam Claude Code e querem enforce design consistency. Bem documentada com MCP tools, agentes e skills prontos; útil em workflows de design system governance e refatoração em larga escala.

README

A tradução para o português deste README ainda está na fila.


Install

claude plugin install kylesnav/delightful-claude-plugin

What You Get

MCP Tools

ToolWhat it does
lookup_tokenLook up tokens by name or category — returns value, tier, and usage guidance
lookup_componentGet the full CSS + HTML pattern for any of 20+ components
map_colorFind the closest Delightful token for any hex/rgb/oklch color
audit_cssCheck a CSS snippet for design system violations with fix suggestions
get_token_cssReturn the complete token stylesheet for copy/paste

Agents

AgentWhen to use
delightful-auditorRead-only compliance checker — scans for hardcoded values, missing states, accessibility gaps
delightful-builderConstruct pages and components using strict design system patterns
delightful-composerAssemble components into complete page layouts with responsive behavior and dark mode

Skills

CommandWhat it does
/build-with-delightfulBuild new UI from scratch — scaffolds tokens, builds components, audits for compliance
/refactor-with-delightfulMigrate existing UI to the design system — audits first, plans migration, replaces systematically
/audit-with-delightfulRun a compliance scan — hardcoded values, missing interaction states, accessibility gaps, dark mode breakage
/present-with-delightfulGenerate slide deck presentations with keyboard nav, sidebar TOC, search, and theme toggle

Reference Docs

Browsable via delightful:// resources:

DocContent
tokens.mdAll 3 tiers of token values
components.md20+ component patterns with CSS/HTML
interactions.mdPOUNCE/SINK press patterns, motion, animations
composition.mdPage layouts, responsive, utilities, checklist
philosophy.mdDesign rationale and principles
accessibility.mdWCAG contract, contrast, focus model
animations.md56 CSS @keyframes across 10 categories
color-system.mdOKLCH color architecture and dark mode shifts
motion-js.mdSpring physics, FLIP, particles, gestures
porting-guide.mdHow to create new platform themes
governance.mdHow to safely extend the token system

Theme Exports

Drop-in theme files for any project:

CSS Custom Properties — themes/css/delightful-tokens.css

@import './themes/css/delightful-tokens.css';

Tailwind Preset — themes/tailwind/delightful-preset.js

// tailwind.config.js
import delightfulPreset from './themes/tailwind/delightful-preset.js'
export default { presets: [delightfulPreset] }

Figma / Style Dictionary — themes/figma/tokens.json Design Tokens Community Group format. Import into Figma with Tokens Studio or process with Style Dictionary.

Usage Examples

Build a component

/build-with-delightful
"Build a settings page with a form, toggle switches, and a save button"

Claude reads the reference docs, scaffolds the token foundation, builds the page with proper OKLCH colors, solid shadows, POUNCE/SINK interactions, and dark mode — then audits for compliance.

Migrate existing code

/refactor-with-delightful
"Refactor this React app to use the Delightful design system"

Claude audits your current code, presents a migration plan, executes each phase, and re-audits until there are zero violations.

Quick token lookup

"What spacing token is closest to 24px?"

The MCP server responds instantly: --space-6: 24px — no skill invocation needed.

Claude Desktop

The MCP server also works standalone in Claude Desktop. Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "delightful": {
      "command": "node",
      "args": ["/path/to/delightful-claude-plugin/mcp-server/index.js"]
    }
  }
}

Then install dependencies: cd /path/to/delightful-claude-plugin/mcp-server && npm install

Part of Delightful

This plugin is the AI interface to the Delightful Design System. The canonical public reference lives at delightful.build.

Related packages:

License

MIT

Ver o original no GitHub

Bom para

Relacionados