Começando

CLI (copiar o código)

Prefere ser dono do código? O CLI copia os componentes para o seu repositório — você edita o que quiser e nada quebra numa atualização.

1Inicialize o projeto

bash

pnpm dlx aura-ui-cli init

Cria o aura.config.json (pastas e aliases) e o src/styles/aura-tokens.css. No CSS global, troque @import "tailwindcss" por um import desse arquivo — ele já inclui o preset do Tailwind.

bash

pnpm add aura-ui-core aura-ui-tailwind class-variance-authority tailwindcss

2Adicione componentes

bash

pnpm dlx aura-ui-cli add button card dialog card-3d

Os arquivos vão para src/components/ui e src/components/effects; utilitários para src/lib.
Dependências entre componentes são resolvidas sozinhas (o dialog traz o que precisa).
No fim, o CLI imprime o pnpm add com os pacotes npm necessários (por exemplo @radix-ui/react-dialog).
aura-ui-cli add --all copia o catálogo inteiro.

tsx

import { Button } from "@/components/ui/button";
import { Card3D } from "@/components/effects/card-3d";

3Mantenha atualizado

bash

pnpm dlx aura-ui-cli diff button

O diff compara a sua cópia com a versão atual do registry, para você trazer melhorias sem perder as suas mudanças. Para gerar overrides de marca (cor primária e raio), use aura-ui-cli theme.

Pacote ou CLI?

Use o pacote npm se quer atualizações automáticas; use o CLI se vai customizar bastante. Dá para misturar: pacote para quase tudo, CLI para os poucos componentes que você quer reescrever.