zark-design
v3.0.3
Published
Design system scaffolder seguindo método ZARK — `npx zark-design init` em modo preset (ZARK pronto) ou custom (cor e logos suas, paleta 50→900 gerada). HTML + JSX side-by-side. Dark mode nativo. Sem dependência runtime.
Downloads
731
Maintainers
Readme
zark-design
ZARK SAAS Design System — instale via
npx zark-design initem qualquer projeto.
O design system fica como REFERÊNCIA pra IA, não como dependência runtime. A IA lê os arquivos JSX + tokens + screenshots e adapta pra qualquer stack (React, Vue, Svelte, Blade, Django templates, HTML puro com Tailwind, etc.).
Uso
# Em qualquer pasta de projeto
npx zark-design init
# Cria ./design-system/ com:
# REFERENCE.md (cérebro: tokens + primitivos + patterns documentados)
# tokens.css (light + dark themes)
# primitives.jsx (Button, Input, Tag, etc. — referência visual)
# components.jsx
# layouts.jsx
# patterns.jsx
# icons.jsx
# brand.jsx
# foundations.jsx
# SHOWCASE.html (preview offline)
# visual-references/ (15 screenshots — ground truth visual)
# assets/ (logo + ícone)Depois, abra a IA na pasta:
claude # ou cursor . / codex / aiderA IA detecta design-system/REFERENCE.md e usa como fonte de verdade pra qualquer trabalho de UI/frontend.
Pasta customizada
npx zark-design init ./ui # instala em ./ui em vez de ./design-system
npx zark-design init ./src/zark # instala em src/zarkSobrescrever instalação existente
npx zark-design init --forceIntegração com .ai-context/CONTEXT.md ou CLAUDE.md
Se o projeto já tem ZARK acoplado (via zark-dev start ou audit), o init adiciona automaticamente uma nota em CLAUDE.md ou .ai-context/CONTEXT.md instruindo a IA a ler o REFERENCE.md antes de qualquer UI.
Filosofia
ZARK é warm + neutral + ember-on-paper. Cor de marca: Liquid Lava (#f56f10).
Os primitivos JSX são referência estrutural — adapte pra stack alvo, nunca copie literal.
Licença
MIT — Maycon Jordan
