Quick Start — Instalar, Configurar, Compilar
Este guia leva você do zero a uma build de tokens funcionando em menos de 10 minutos. Você vai instalar o pacote Aplica Theme Engine, montar um workspace de consumidor e produzir seu primeiro dist/.
Estrutura do Workspace de Consumidor
O Aplica Theme Engine segue um modelo core + consumidor. O pacote é dono do engine de geração; seu projeto é dono da configuração, dos dados gerados e do output final de build.
Configuração de Tema
A configuração de tema fica em theme-engine/config/. Esses arquivos definem o que o engine gera — cores de marca, tipografia, modos e escalas de espaçamento. O engine os lê; seu projeto os versiona.
Configuração de Transformers
A configuração de transformers controla como o engine converte data/ em dist/. Ela define quais camadas de token construir, quais plataformas de output gerar e onde cada arquivo de output vai.
Referência da CLI
A CLI aplica-theme-engine é a interface principal para gerar e construir design tokens. Todos os comandos rodam contra o workspace de consumidor atual — o engine lê sua configuração de aplica-theme-engine.config.mjs e grava todo o output dentro da raiz do seu projeto.
Build e Integração CI/CD
Este artigo cobre os scripts recomendados de package.json, estratégias de build para diferentes workflows de time, e como integrar a geração de tokens em um pipeline CI/CD.
Diagnóstico de Problemas
Este artigo cobre os erros mais comuns e como resolvê-los, organizados pela etapa em que aparecem.