CLI

init

Inicializa a kodda UI no projeto. Detecta shadcn/ui, valida dependências e cria a configuração.

npx @koddaai/ui init

Cria:

• kodda.json — arquivo de configuração
• Diretórios para componentes, hooks e tokens

add

Adiciona um ou mais componentes ao projeto. Resolve dependências transitivas automaticamente.

npx @koddaai/ui add <componente>
npx @koddaai/ui add status-badge data-table page-header

O que acontece:

1. Resolve a árvore de dependências (kodda → shadcn → npm)
2. Instala primitivos shadcn necessários
3. Instala pacotes npm necessários
4. Copia os arquivos do componente
5. Reescreve imports para os paths do projeto
6. Atualiza kodda.json com versão e hash

list

Lista todos os componentes disponíveis no registry, agrupados por categoria.

npx @koddaai/ui list

Mostra o status de instalação de cada componente (instalado/não instalado).

diff

Mostra as diferenças entre a versão local e a versão do registry.

npx @koddaai/ui diff <componente>
npx @koddaai/ui diff --all

Output colorido com adições (verde), remoções (vermelho) e hunks (cyan).

update

Atualiza componentes para a versão mais recente do registry.

npx @koddaai/ui update <componente>
npx @koddaai/ui update --all
npx @koddaai/ui update --all --force
npx @koddaai/ui update --all --dry-run

O update detecta modificações locais (via hash SHA-256) e pede confirmação antes de sobrescrever.