Savepoints e branches

Dois comandos ajudam você a gerenciar o estado do lado do Bubble a partir da CLI sem sair do seu workspace: savepoint para pontos de salvamento do editor na branch atual, e branch para listar ou criar versões do aplicativo Bubble.

Savepoints

Um savepoint é um ponto de restauração do editor do Bubble. Crie um antes de uma alteração arriscada para ter um ponto para o qual retornar. Todos os subcomandos de savepoint atuam no workspace da branch atual.

Criar

buildprint savepoint create "before checkout refactor"

A descrição é obrigatória — escreva algo que faça sentido semanas depois.

Listar

buildprint savepoint list

Exibe as linhas <timestamp> <description> [email] para cada savepoint na branch atual. Use --json para uma saída estruturada.

Restaurar

buildprint savepoint restore <timestamp>

Restaura o editor do Bubble para o savepoint fornecido. Depois, execute buildprint sync para que o workspace corresponda ao estado restaurado do Bubble. A CLI lembrará você sobre a sincronização na sua saída.

Savepoints são o caminho de reversão mais seguro quando um agente Buildprint faz alterações indesejadas. Restaure, sincronize e inicie uma nova sessão com um prompt mais específico.

Branches

O comando branch lê e cria versões do aplicativo Bubble (o que o Bubble chama de "branches" no nível do editor — test, live e versões personalizadas).

Listar

buildprint branch list <appId>

Exibe a árvore de branches do aplicativo. Use --json para um formato legível por máquina.

Criar

buildprint branch create my-app "feature-checkout" --from staging

--from <version> — branch base de onde bifurcar. Padrão test.
--description <text> — descrição opcional.
--json — exibe a resposta bruta da API e pula a materialização do workspace local.
--no-workspace-sync — não materializa um workspace local para a nova branch mesmo quando você estiver dentro da raiz de um aplicativo.

Se você executar buildprint branch create de dentro da raiz de um aplicativo, poderá pular o argumento posicional appId e apenas passar o nome da nova branch:

buildprint branch create "feature-checkout" --from staging

Os nomes das branches são normalizados no servidor: espaços removidos das extremidades, convertidos para minúsculas e espaços convertidos em hífens.

Criar uma branch a partir de uma base que seu token não consegue ler falhará com um erro de permissão. Corrija isso criando a partir de uma base à qual o token tenha acesso (geralmente test), ou atualize as permissões de colaborador no seu aplicativo Bubble.

Isso foi útil?