CLI

Gerenciando alterações e sincronização

Gerenciando alterações e sincronização

O Buildprint funciona melhor quando você o trata como um fluxo de trabalho de branch local: sincronizar, editar, revisar, validar e aplicar.

Fluxo recomendado

  1. Comece no workspace da branch e execute buildprint sync para buscar o snapshot mais recente do Bubble.

  2. Edite os arquivos necessários.

  3. Revise seu trabalho com git status e git diff.

  4. Execute buildprint check antes de aplicar.

  5. Faça o commit de suas alterações. O buildprint apply espera uma árvore de trabalho (worktree) limpa.

  6. Se o Bubble tiver mudado enquanto você trabalhava, execute buildprint sync novamente e resolva quaisquer conflitos de merge.

  7. Opcionalmente, visualize o resultado com buildprint apply --dry-run e, em seguida, execute buildprint apply.

Como o sync se comporta

  • Ele busca o snapshot mais recente do Bubble para a branch atual e o traz para seu workspace.

  • Se sua branch local não tiver alterações conflitantes, o sync pode ser um no-op, um fast-forward ou um merge normal.

  • Se houver conflitos, você receberá marcadores de conflito comuns do git nos arquivos. Resolva-os, use git add e git commit como faria em qualquer outro repositório.

  • Use buildprint sync --no-merge se quiser buscar o snapshot mais recente primeiro e fazer o merge manualmente depois.

Como o apply se comporta

  • O apply envia suas alterações locais commitadas de volta para o Bubble.

  • Ele se recusa a ser executado se a árvore de trabalho estiver suja, pois aplica o estado commitado atual.

  • Por padrão, ele também executa uma verificação interna para que problemas óbvios sejam detectados antes que qualquer coisa seja enviada.

  • Se o Bubble rejeitar a gravação porque a base mudou, sincronize novamente, resolva a divergência e tente de novo.

Boas práticas

  • Mantenha os commits pequenos e fáceis de revisar.

  • Execute buildprint check --all se desejar uma verificação completa do workspace em vez de apenas arquivos alterados.

  • Use buildprint tree <target> quando precisar entender a estrutura de uma página ou elemento antes de editar.

  • Depois de resolver conflitos, execute as verificações novamente antes de aplicar.

Isso foi útil?