convez.ai
MCP ServerDesign & UIIntermediário
sanghyeonKim0201

sh-ui — Sistema de Design Multiplatforma com MCP

sanghyeonKim0201/sh-ui

CLI de design system com tokens compartilhados e suporte MCP para IA

Ver no GitHub
BomPluginScore · de 0 a 100

Sistema de design pessoal (design tokens + componentes) com CLI para scaffolding de projetos e adição de componentes em React/Next.js e Flutter. Funciona como MCP server dentro de IDEs com suporte a AI, permitindo automação de criação e gerenciamento de componentes com configuração baseada em arquivos JSON.

Instalação

$npx convez-ai sanghyeonKim0201/sh-ui

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
100%
Último commit
há 4 dias
Versão
v0.123.0
Issues abertas
10
Contribuidores
4

Casos de uso

  • Scaffolding rápido de projetos Next.js/Flutter com design system pré-configurado
  • Adicionar componentes padronizados em projeto existente via CLI
  • Integrar design tokens (primitivos → semânticos → componentes) com conversão automática
  • Usar como MCP server para assistentes de IA consultarem componentes disponíveis

Veredito

Ferramenta especializada em design systems com abordagem moderna (cópia de código type shadcn). MCP server integrado torna útil para fluxos de IA, mas escopo bem definido — adequada para equipes que já trabalham com Next.js/Flutter e querem unificar tokens entre plataformas.

README

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

sh-ui

김상현 개인 디자인 시스템.

빠른 시작

# 새 프로젝트 스캐폴드 (Next.js / Flutter)
npx sh-ui-cli create my-app

# 기존 프로젝트에 sh-ui 도입
npx sh-ui-cli init
npx sh-ui-cli add tokens button

플레이그라운드에서 테마를 편집하고 그대로 반영된 명령어를 얻으려면 sh-ui.dev/create 참고.

철학

  • 코드 소유권은 사용자에게 — shadcn처럼 컴포넌트 소스를 프로젝트로 복사하는 방식
  • 하나의 토큰, 여러 플랫폼 — React(Next.js), Flutter, 그 이상
  • 설정 파일 기반 변환 — sh-ui.config.json에 정의한 테마/radius/스타일로 복사 시점에 변환

npm 패키지

패키지역할
sh-ui-cli통합 CLI — 프로젝트 스캐폴드(create) · 컴포넌트 복사·설정 관리(init/add/list/remove) · IDE-내 AI 용 MCP 서버(mcp)

구조

sh-ui/
├── packages/
│   ├── tokens/       # 디자인 토큰 (primitive / semantic)
│   ├── registry/     # 플랫폼별 컴포넌트 소스 (복사 대상)
│   ├── cli/          # sh-ui-cli — 통합 CLI (create/init/add/list/remove/mcp)
│   ├── changelog/    # versions.json (단일 소스)
│   └── llms/         # llms.txt 생성 (AI 도구용 컴포넌트 인벤토리)
└── apps/
    └── docs/         # 문서 사이트 (Next.js)

토큰 계층

  1. Primitive — 실제 값 (color.neutral.500, spacing.4)
  2. Semantic — primitive 참조 (background.default, text.primary)
  3. Component — (선택) semantic 참조 (button.primary.background)

컴포넌트는 오직 semantic 계층만 참조한다.

개발

pnpm install
pnpm dev        # docs 사이트 (localhost:3000)
pnpm -r test    # 패키지별 테스트

기여 / 보안

라이선스

MIT

Ver o original no GitHub

Bom para

Relacionados