create-trindtech-app

Bootstrap público pro CLI privado da Trindtech (@trindtech/create-next). Cuida do setup do token do GitHub Packages no primeiro uso e roda o scaffolder.

Uso

npx create-trindtech-app meu-projeto

Primeira vez: o wrapper detecta que falta o token do GHP, te orienta a gerar um Personal Access Token do GitHub (com scope read:packages), pede via prompt seguro, salva em ~/.npmrc e roda o scaffolder.

Vezes seguintes: pula direto pro scaffolder.

Pré-requisitos

• Node 20+
• Estar adicionado na org trindtech no GitHub
• Personal Access Token com scope read:packages (o wrapper te orienta a gerar)

Como funciona

1. Lê ~/.npmrc e checa se tem //npm.pkg.github.com/:_authToken=<token> (não-vazio).
2. Se faltar, mostra link pra gerar o PAT e pergunta o token (input mascarado, formato validado).
3. Limpa scope routings legacy (@trindtech:registry=https://npm.pkg.github.com e @trindtech-private:registry=...) que versões anteriores do wrapper haviam adicionado — eles quebram projetos que dependem de @trindtech/utils (no npm público).
4. Mescla com configs existentes no ~/.npmrc sem duplicar (idempotente). Permissão 0600.
5. Executa npx --registry=https://npm.pkg.github.com --yes @trindtech/create-next <args> — força a busca do CLI no GHP sem rotear o scope globalmente.

Por que --registry e não scope routing?

Versões anteriores escreviam @trindtech:registry=https://npm.pkg.github.com no ~/.npmrc, mandando todo o scope @trindtech pro GHP. Isso quebrava projetos que dependem de @trindtech/utils (publicado no npm público). Agora o --registry afeta apenas a chamada do CLI; o scope @trindtech segue indo pro npm público no resto.

Segurança

• O token nunca é ecoado no terminal nem logado.
• O ~/.npmrc é gravado com chmod 0600 (só o dono lê).
• Esse wrapper não tem o código do scaffolder — apenas a lógica de setup. Outsiders sem acesso à org Trindtech recebem 403 do GitHub Packages ao tentar usar.

Release

cd scripts/create-trindtech-app
# bump version no package.json
git tag wrapper-v1.1.1
git push origin wrapper-v1.1.1

Workflow .github/workflows/publish-wrapper.yml dispara e publica no npm público.