Toda alteração publicada sai com versão, changelog, tag e GitHub Release. Isso vale para o binário derivado e para o framework.
O binário derivado
- Atualize
versionempackage.json. - Registre a mudança em
CHANGELOG.md, no formato Keep a Changelog. - Rode
bun run validate. - Commit
release: mycli vX.Y.Ze tagvX.Y.Z. Envie amaine só essa tag:git push origin main vX.Y.Z. - O workflow
release.ymlcompila os binários para linux-x64, linux-arm64, darwin-x64, darwin-arm64 e windows-x64, geraSHA256SUMSe publica a GitHub Release com as notas do changelog. - Confira a release e baixe um binário para testar
--version.
Uma tag publicada não se move. Correção posterior recebe nova versão.
Build local
bun run build # dist/mycli para a plataforma atualbun run build:all # dist/mycli-<plataforma> para todas./dist/mycli --versionbun build --compile embute a biblioteca nativa do OpenTUI, a documentação
de docs/ e o package.json. Para compilar para outra plataforma, instale
antes os pacotes nativos de todos os alvos:
bun install --frozen-lockfile --os="*" --cpu="*" --libc="*". O comando não
cita pacote de propósito: com @opentui/core no lugar, o Bun 1.4 não instala
@opentui/core-linux-arm64-musl e o alvo linux-arm64 falha.
Instalar o binário
Copie o executável para um diretório do PATH ou publique a release e
oriente curl -L <url> -o /usr/local/bin/mycli && chmod +x /usr/local/bin/mycli.
Nenhum runtime precisa estar instalado na máquina de destino.
O framework
- Atualize
versionempackage.jsone, sedocs/user/mudou,ebook/VERSION. - Registre em
CHANGELOG.md. - Rode
bun run ebookquando o guia mudou ebun run validate. - Commit
release: Termfy vX.Y.Z, tag e push. - O workflow publica a release com o PDF e o EPUB do guia.
- Nos projetos derivados, peça ao agente para usar
termfy-initno modo de manutenção das skills para receber a versão publicada.
No Hub da Promovaweb
Framework e starter kit são submódulos do Hub. Depois de publicar um deles,
o gitlink, a versão, o changelog, a tag e a release do Hub são atualizados,
conforme RELEASES.md.