# Instalação e adoção

## Projeto completo

A base inspecionada é TailAdmin HTML Pro 2.4.0; o lockfile original identifica a raiz como 2.3.1, com ranges correspondentes ao `package.json`. Isso já ocorre no ZIP recebido. Foram preservadas as versões e bibliotecas, sem migração. O pacote não transfere licença do TailAdmin Pro nem direitos de redistribuição pública. A declaração ISC do package original foi preservada; não a interprete como liberação irrestrita do template proprietário.

Node disponível neste ambiente: v24.19.0. O AGENTS exige Node >=22.18 por Babel 8. Restauração: `npm ci`, mediante autorização de instalação. Desenvolvimento: `npm start`. Build real: `npm run build`, saída `build/`. O prebuild gera exports/templates. Não use `deploy`/`preview` para publicar esta demonstração.

## Núcleo em outro projeto

1. Copie `design-system/` respeitando os direitos de marca. Não copie dashboards para consumir somente componentes.
2. Importe `design-system/troca-pontos.css`; coloque `.tp-core` no contêiner.
3. Use `.tp-button`, `.tp-input`, `.tp-card`, `.tp-table` e os contratos em `componentes.md`.
4. Ative `.dark` no ancestral e `data-density="compact"` quando adequado. O exemplo mínimo demonstra ambos os papéis de CSS/JS sem Tailwind em runtime.
5. Para interações completas, importe `registerDesignSystem` e registre antes da única chamada a `Alpine.start()`. Preserve `@alpinejs/persist`, i18n e RTL no adaptador do projeto.
6. Configure fontes licenciadas no destino e valide aplicação da marca, sem reduzir a arte abaixo do mínimo da p.11 — que é **dois**: 170 px para o **wordmark** na versão principal (`--tp-logo-width`) e 170 px para a **caixa inteira** na versão preferencial (`--tp-logo-lockup-width`, com o wordmark em 128,15 px dentro).

O portal completo requer o build HTML/Tailwind/Webpack. O núcleo e `examples/minimo` funcionam com arquivos estáticos; o exemplo não depende da folha exclusiva do portal.

## Reversão

Antes de integrar em projeto existente, mantenha backup ou commit da versão anterior. Nesta execução, a linha de base está em `tmp/baseline/source-before.zip` e o ZIP TailAdmin original permanece inalterado. Para reverter, restaure apenas arquivos do projeto alterados, depois remova os novos arquivos listados no manifesto conforme revisão da equipe; não apague fontes de referência ou dados de outro projeto. Regenere o build com o lock correspondente.