Pular para o conteúdo principal
Branches permitem experimentar novas ideias, funcionalidades ou redesigns sem afetar seu app. Cada branch tem seu próprio chat e sua própria prévia ao vivo. Você pode trabalhar em várias branches ao mesmo tempo e depois fazer o merge de cada uma no seu app quando estiver satisfeito.
Branches funcionam junto com uma conexão do GitHub. A Base44 mantém cada branch como uma branch real no seu repositório, e você também pode construir em uma branch que já está lá.
O menu de branches listando várias branches ao lado de uma prévia do app

Trabalhe em várias branches ao lado do seu app principal

Formas de usar uma branch

  • Teste um redesign. Experimente uma nova aparência para seu app e compare-a com a versão atual. Se mudar de ideia, deixe a branch de lado.
  • Mantenha seu app ao vivo pronto. Quando uma pequena correção surgir no meio do projeto, corrija e publique da main imediatamente. Seu trabalho maior em andamento permanece com segurança em sua branch.
  • Construa uma funcionalidade para lançar depois. Trabalhe adiantado em relação a um lançamento e mantenha a funcionalidade em uma branch até o dia do lançamento.
  • Trabalhe em paralelo. Construa em várias branches ao mesmo tempo e trabalhe com sua equipe em diferentes ideias simultaneamente, cada uma em sua própria branch.

Como as branches funcionam

A versão principal do seu app é chamada main. Quando você cria uma branch, a Base44 inicia uma linha separada de trabalho a partir do estado atual da main. As branches rodam em paralelo, então você pode testar alterações sem tocar na main. Algumas partes do seu app pertencem a cada branch, e outras são compartilhadas com a main:
Uma branch usa seus dados reais e ao vivo.
  • Registros que você adiciona, altera ou exclui enquanto visualiza uma branch afetam os mesmos dados que seu app usa em todos os lugares.
  • Para experimentar sem tocar em seus dados ao vivo, alterne sua prévia para dados de teste enquanto trabalha. Dados de teste estão disponíveis no plano Builder e superior. Saiba mais sobre testar seu app com dados de teste.

Criando uma branch

Descreva o que você quer construir, e a Base44 cria a branch e começa a construir imediatamente. A Base44 dá nome à branch a partir da sua primeira mensagem. Os nomes têm 3 palavras ou menos e são sempre em inglês, independentemente do idioma em que você escreve. Não é possível renomear uma branch. Você também pode usar branches no seu celular, em um navegador mobile ou no app da Base44. O menu de branches só aparece depois que seu app tem uma branch, então crie sua primeira branch em um computador ou peça ao chat de IA para iniciar uma. Depois disso, você pode alternar entre branches, construir e fazer merge pelo celular.
Antes de criar uma branch: Se seu app foi construído há algum tempo, pode ser necessário fazer uma alteração na main antes de criar sua primeira branch. Se isso se aplica ao seu app, a Base44 avisa você quando tentar.

Iniciando uma nova branch

Inicie uma branch pelo menu de branches quando tiver uma nova ideia para construir. Para criar uma branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Clique em Criar novo branch.
  4. Digite o que deseja construir na caixa de chat.
  5. Envie a mensagem.
O menu de branches aberto sob o nome do app, mostrando Main chat e um painel Create your first branch com o botão Create new branch destacado

Criando sua primeira branch pelo menu de branches

Uma branch que você cria pelo menu de branches sempre começa a partir da main. Se você criar uma branch enquanto está em outra branch, a nova branch ainda começa a partir da main.

Criando uma branch privada

Torne uma branch privada quando quiser trabalhar em uma ideia antes que outras pessoas a vejam. Qualquer pessoa que pode editar o app pode criar uma. Uma branch privada e o chat dela ficam visíveis apenas para você, então o dono do app e seus outros colaboradores não veem seu trabalho em andamento. Ela mostra um cadeado ao lado do nome no seu menu de branches. Quando você faz o merge, suas alterações aparecem na main para todos, como de costume. Você escolhe se uma branch é privada ao criá-la e não pode mudar isso depois. Se você for removido como colaborador do app, suas branches privadas são excluídas.
Onde as branches privadas estão disponíveis:
  • Colaboradores: A opção Branch privado só aparece em apps com colaboradores. Se você constrói sozinho, convide um colaborador e a opção aparece, mesmo antes de a pessoa aceitar.
  • Apps importados: Branches privadas não estão disponíveis em apps importados do GitHub.
  • App mobile: Branches privadas não estão disponíveis no app mobile da Base44.
Para criar uma branch privada:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Clique em Criar novo branch.
  4. Selecione Branch privado no topo da caixa do chat.
  5. Digite o que deseja construir na caixa do chat.
  6. Envie a mensagem.
Uma captura de tela da tela Create new branch no chat de IA, com Private branch selecionado e destacado na caixa do chat

Selecionando Private branch antes de enviar sua primeira mensagem

Criando uma branch a partir de uma mensagem

Crie uma branch a partir de qualquer mensagem que você enviou no chat principal para tentar uma direção diferente daquele ponto. A nova branch começa do seu app como ele estava naquela mensagem, e você continua na main enquanto ela é criada. Essa opção está disponível na main em um navegador desktop, mas não enquanto seu app está em build. Para criar uma branch a partir de uma mensagem:
  1. Abra seu app no editor do app.
  2. Passe o cursor sobre uma mensagem que você enviou no chat principal.
  3. Clique no ícone Criar branch a partir daqui abaixo dela.
    Uma mensagem enviada no chat principal com o ícone Branch from here destacado

    O ícone Branch from here abaixo de uma mensagem que você enviou

  4. Quando a branch estiver pronta, abra-a pelo menu de branches no topo do painel de chat.

Pedindo à IA para criar uma branch

Você pode pedir ao chat de IA para iniciar uma branch para você. Assim, uma mudança grande é construída longe do seu app ao vivo. Por exemplo, “Construa o novo fluxo de reservas em uma branch separada.” Isso funciona em qualquer app, na main ou em uma branch. A IA inicia a branch a partir da main, com seu pedido como primeira mensagem, e continua construindo lá sozinha. Você fica onde está, e um link para a nova branch aparece no chat. Se você pedir uma mudança grande no seu app publicado, o chat de IA pode sugerir construí-la primeiro em uma nova branch. Por exemplo, substituir um fluxo principal ou redesenhar várias páginas de uma vez. Assim, seu app ao vivo continua como está enquanto você testa a mudança. Se você já está em uma branch e pede algo sem relação com o trabalho dela, o chat de IA pode sugerir uma branch separada.
Quando a IA sugere uma branch:
  • Modo Construir no computador: A sugestão só aparece no modo Construir, em um navegador no seu computador. Você não a vê nos modos Planejar ou Discutir, nem no app mobile da Base44.
  • Só mudanças de design e de funcionalidades: A IA não sugere uma branch para mudanças nos seus dados, campos de entidade, regras de acesso ou configurações como autenticação e pagamentos. Isso porque as branches compartilham esses itens com a main.
  • Imported apps: Em apps importados do GitHub, a IA só sugere uma branch quando você já está em uma.
Para responder a uma sugestão de branch:
  1. Confira a sugestão Criar novo branch no chat de IA. Ela mostra o que a IA construiria na nova branch.
  2. Clique em uma das opções:
    • Start: A Base44 cria a branch a partir da main e começa a construir lá, e você fica onde está. Um link para ela aparece no chat.
    • Fazer depois: A IA fecha a sugestão e não inicia uma branch. Para fazer a mudança na main ou na branch em que você está, peça ao chat de IA para seguir em frente.
O editor do app na Main com uma sugestão Create new branch no chat de IA e o botão Start destacado

A IA sugerindo uma nova branch antes de uma mudança grande

Importando do GitHub

Quando seu app está conectado ao GitHub, você pode construir em uma branch que já existe no seu repositório. A Base44 trabalha nessa mesma branch, então suas alterações e as da Base44 vão para a mesma branch no seu repositório. Para importar uma branch do GitHub:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Clique em Importar do GitHub.
  4. Pesquise a branch que deseja e selecione-a.
  5. Clique em Importar.
Você importa do repositório ao qual seu app está conectado. Uma branch que você cria na Base44 gera uma nova branch nesse mesmo repositório.

Trabalhando em uma branch

Enquanto você está em uma branch, o nome dela substitui o nome do seu app no topo do painel de chat, e um ícone giratório aparece quando a IA está trabalhando. Você constrói em uma branch da mesma forma que constrói na main: descreva o que deseja no chat. Selecionar um elemento e fazer uma edição visual também salva na branch em que você está, assim como suas alterações no chat. Algumas coisas funcionam de forma diferente em uma branch:
  • Mesclar no main substitui o botão Publicar. Você publica as alterações a partir da main depois do merge.
  • A prévia mostra a versão da branch do seu app.
  • A URL da página inclui a branch, então você pode compartilhar um link que abre o editor do app nessa branch.
O editor do app em uma branch, com o nome da branch no topo e Merge to main destacado

Trabalhando em uma branch, com Merge to main no lugar de Publish

Branches rodam em paralelo. Envie uma solicitação em uma branch, mude para outra e continue construindo lá enquanto a primeira termina. Seu app executa vários builds ao mesmo tempo, então você e sua equipe podem avançar em várias ideias de uma vez, cada uma em sua própria branch.O menu de branches mostra quais branches estão em build, para que você possa acompanhá-las.

Alternando entre branches

Você pode mover-se entre a main e suas branches a qualquer momento, e cada branch mantém suas alterações até você fazer o merge. Em uma branch, você também pode clicar no X ao lado de Mesclar no main para voltar à main. O ícone ao lado de cada branch mostra seu status atual. Passe o cursor sobre o ícone para ver o rótulo: Para alternar para outra branch ou voltar à main:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Selecione uma branch na lista, ou selecione Chat principal para voltar à main.
O menu de branches aberto em uma branch, mostrando Main chat acima da lista de branches

Alternando entre a main e suas branches

Você pode alternar branches enquanto a IA está construindo, e ela continua trabalhando na branch que você deixou. Salve ou descarte quaisquer edições na main primeiro.

Entrando na branch de um colaborador

Quando você trabalha em um app com outras pessoas, os avatares no topo do editor do app mostram em qual branch cada pessoa está. Você pode ir direto para a branch de um colaborador, e quando alguém entra na branch em que você está, a Base44 mostra uma mensagem curta avisando que a pessoa entrou na sua branch. Para entrar na branch de um colaborador:
  1. Abra seu app no editor do app.
  2. Passe o cursor sobre o avatar de um colaborador no topo do editor do app para ver o nome e a branch dele.
    Avatar de um colaborador no topo do editor do app, com uma dica mostrando o nome e a branch dele

    O avatar de um colaborador mostrando em qual branch ele está

  3. Clique no avatar para abrir a branch em que ele está.

Fazendo alterações no app inteiro

Você faz a maior parte da construção em uma branch, mas algumas ações afetam todo o seu app, não apenas uma branch. Elas sempre acontecem na main, mesmo enquanto você está trabalhando em uma branch:
  • Publicar seu app
  • Criar ou alterar segredos, conectores e workflows
  • Alterar as configurações de tema do seu app
  • Desfazer uma mensagem no chat, ou editar e reenviar uma
  • Adicionar uma página do Figma
  • Pedir à IA para adicionar, alterar, excluir ou importar registros
Se você pedir uma dessas ações em uma branch, a Base44 pede que você a faça na main ou faça o merge da branch primeiro.

Usando dados de teste

Os dados de teste permitem que você experimente em uma branch sem tocar em seus registros ao vivo. Seu app tem 1 conjunto de dados de teste compartilhado pela main e por todas as branches. Por isso, uma nova branch não recebe uma cópia própria e não começa vazia. Ela mostra os mesmos registros de teste da main, e os registros de teste que você adiciona em qualquer branch aparecem em todos os lugares. O chat de IA não adiciona nem altera registros a partir de uma branch. Para que a IA adicione dados de teste para você, peça na main. Para adicionar dados de teste enquanto trabalha em uma branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Selecione sua branch.
  4. Clique em Pré-visualização.
  5. Clique no ícone Ativar dados de teste no topo da prévia.
  6. Adicione registros enquanto usa seu app.

Alterando entidades

Algumas alterações de entidades funcionam em uma branch, e outras acontecem na main. Em uma branch, você pode:
  • Criar entidades: Você define tudo, incluindo as permissões de dados da entidade.
  • Adicionar campos a entidades existentes: Deixe os novos campos opcionais, porque seus registros existentes ainda não os têm.
As duas alterações aparecem na prévia da branch imediatamente. Na main, você:
  • Remove uma entidade ou um campo.
  • Altera o tipo de um campo existente, ou se ele é obrigatório.
  • Altera permissões de dados.
Faça essas alterações na main, e sua branch as recebe imediatamente, sem precisar de merge ou atualização. Registros são os dados ao vivo do seu app, compartilhados com a main, então peça alterações de registros à IA na main. Os registros que você mesmo adiciona, altera ou exclui na prévia da branch alteram os mesmos dados que seu app usa em todos os lugares.

Editando funções de backend

Você pode adicionar e alterar funções de backend em uma branch. A branch recebe sua própria cópia de cada função que você altera, incluindo qualquer código compartilhado que ela usa. Quando você faz o merge da branch, suas alterações são implantadas na main. A versão de uma função que roda na prévia da branch depende de quem a usa:
  • Você ou um editor, conectado ao app: A versão da branch.
  • Qualquer outra pessoa, como um visitante não conectado ou um usuário do app: A versão da sua última publicação. Um fluxo que depende de uma dessas pessoas só pode usar as alterações da branch depois que você fizer o merge e publicar.
Para testar uma função sozinha, use Test Function e Logs na aba Code. Em uma branch, eles executam a versão da branch. As funções que você não alterou executam a versão da main.
Quando as funções ficam na main:
  • A primeira função de backend do seu app é criada na main. Depois disso, você pode trabalhar em funções a partir de uma branch.
  • Em um app importado do GitHub, as alterações de backend sempre acontecem na main.

Editando agentes no app

Você pode criar, editar e excluir agentes no app em uma branch, pelo chat de IA ou pela página Agentes no painel do seu app. Em uma branch, a página Agentes mostra os agentes da branch, e suas alterações ficam na branch até você fazer o merge. Até lá, seu app, incluindo a prévia da branch, continua executando os agentes da main. Se a branch main do seu app estiver protegida, o editor de agentes na main é somente leitura. Para fazer alterações, crie uma branch. Quando você clica em Adicionar agente na main e envia a solicitação, a Base44 a move para uma nova branch para você.

Editando código

A aba Código mostra os arquivos do seu app como estão na branch em que você está. Você pode editá-los ali, e o que você salvar fica na branch até você fazer o merge. A maioria dos arquivos é salva direto na branch, incluindo os arquivos por trás das suas páginas, layout, estilo e funções de backend. Assim, a main não é alterada. Alguns arquivos alteram todo o seu app, não apenas uma branch. Se você tentar salvar um deles, a Base44 interrompe o salvamento e diz o que fazer:
  • Arquivos de entidades: Peça a alteração no chat da branch ou mude para a main. Veja entidades em uma branch para saber o que uma branch pode alterar por conta própria.
  • Qualquer coisa que alteraria seu app ao vivo: Faça a alteração na main, e sua branch a recebe sem precisar de merge.
A aba Code aberta em uma branch, com a árvore de arquivos da branch e Merge to main no canto superior direito

A aba Code em uma branch, mostrando os arquivos da própria branch

Como funciona reimplantar uma função de backend:
  • Acontece na main: Quando você edita uma função de backend na main, você a salva com Salvar e reimplantar. Em uma branch, o botão é Salvar, então mude para a main para reimplantar uma função.
  • Seu app ao vivo mantém a versão publicada: Reimplantar atualiza a função na sua prévia e quando você a testa no editor. Seu app ao vivo continua executando a versão da sua última publicação até você publicar de novo.
  • Publicar coloca tudo da main no ar: Você não pode publicar uma função sozinha. Quando você publica, todas as suas alterações na main vão ao ar juntas, incluindo a função reimplantada.
  • Workflows usam a nova versão na hora: Quando um workflow chama a função, ele executa a versão mais recente sem precisar publicar.

Usando o histórico de versões

Cada branch tem seu próprio histórico de versões. Use-o para ver como a branch evoluiu, compará-la com a main e voltar a qualquer ponto anterior.

Restaurando uma versão

Restaurar uma versão altera apenas essa branch. A main continua exatamente como está.
  • O que volta: As páginas, o design, as entidades e as funções de backend da branch voltam a essa versão, e o chat volta à mensagem que a criou.
  • O que permanece: Seus registros, porque são compartilhados com a main. Suas versões posteriores também permanecem na lista, para que você possa avançar de novo.
Você pode restaurar uma versão enquanto a branch ainda está ativa. O histórico de versões de uma branch com merge feito continua legível. Para restaurar uma versão anterior de uma branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
  3. Clique no ícone Histórico de versões no topo do painel de chat.
  4. Clique em uma versão na lista para carregá-la na prévia.
  5. Clique no ícone Mais opções ao lado dessa versão.
  6. Clique em Voltar para esta versão.
Menu More options de uma versão da branch no Version History com Revert to this version destacado

Restaurando uma versão anterior de uma branch

Restaurando e publicando de uma branch:
  • Publicar esta versão está disponível apenas na main, porque publicar sempre lança seu app principal. Para lançar o trabalho de uma branch, faça o merge dela na main e publique de lá.
  • Restaure uma versão depois que a branch terminar o build e qualquer atualização da main estiver concluída. Se a branch estiver ocupada, a Base44 avisa você, e você pode restaurar assim que ela terminar.

Comparando com a main

Antes de fazer o merge, você pode verificar exatamente como o código de uma versão difere da main. A Base44 abre uma janela Alterações em comparação com main que lista cada arquivo diferente e o que mudou em cada um. Para comparar uma versão da branch com a main:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
  3. Clique no ícone Histórico de versões no topo do painel de chat.
  4. Clique no ícone Mais opções ao lado da versão que deseja comparar.
  5. Clique em Comparar código com main.
    Menu More options de uma versão da branch no Version History com Compare code vs main destacado

    Comparando uma versão da branch com a main

  6. Clique em um arquivo na lista para ver o que mudou nele.
    A janela Changes compared with main listando os arquivos alterados, com um arquivo exibido lado a lado

    A janela Changes compared with main


Atualizando a partir da main

Se a main mudar enquanto sua branch está aberta, um card aparece acima da caixa de chat na branch. Ele informa quanto mudou na main e se algo se sobrepõe à sua branch. Quando você atualiza, a IA combina as alterações da main com sua branch. Se algumas alterações se sobrepõem, a IA as resolve para você. Se as 2 versões genuinamente conflitam, a IA faz uma pergunta no chat para que você decida o que manter. Você também pode iniciar uma atualização pelo menu de branches. Clique no ícone Mais ações ao lado de uma branch e depois em Atualizar a partir do main. Para trazer as alterações mais recentes da main para sua branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
  3. Clique em Atualizar branch no card de atualização acima da caixa de chat.
Um card de atualização acima da caixa de chat dizendo 1 new message on main, Nothing overlaps, Ready to update, com um botão Update branch

O card de atualização que aparece acima da caixa de chat quando a main mudou

Se uma atualização encontrar um problema, a Base44 a reverte e o trabalho da sua branch permanece inalterado.

Fazendo merge na main

O merge traz tudo o que você construiu na branch para a main. Suas alterações só chegam aos usuários do seu app quando você publica da main, então você decide o que sai e quando. Em um app importado do GitHub, você faz o merge por um pull request. Veja como trabalhar com pull requests. Depois do merge:
  • O chat da main mostra um resumo das alterações da branch.
  • A branch permanece na sua lista de branches como merged. Você ainda pode ler o chat dela, mas o código é somente leitura, e a prévia mostra a main como está agora.
  • Para perguntar sobre o trabalho da branch, abra-a e feche o aviso. O chat de IA reabre no modo Discutir, para que a IA possa responder perguntas sobre o código da branch sem alterá-lo. Para voltar, clique em Abrir chat principal.
Você também pode pedir ao chat de IA para fazer o merge de uma branch. Ele adiciona ao chat um card de um clique que faz isso para você. Ou faça o merge pelo menu de branches: clique no ícone Mais ações ao lado de uma branch e depois em Mesclar no main. Para fazer o merge de uma branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
  3. Clique em Mesclar no main abaixo da resposta mais recente da IA ou no topo do editor.
  4. Revise a confirmação e depois clique em Mesclar no main.
O editor do app em uma branch com o botão Merge to main destacado na barra superior

Clique em Merge to main no topo do editor e depois publique da main quando estiver pronto

Se a branch conflitar com alterações feitas na main, a Base44 pede que você a atualize primeiro. Atualize a branch a partir da main e depois faça o merge novamente.

Excluindo uma branch

Exclua uma branch quando terminar uma ideia e quiser removê-la da sua lista. Seu app e suas outras branches permanecem como estão.
Excluir uma branch é permanente. Isso remove a branch e seu chat, e não pode ser desfeito. Para manter o trabalho, faça o merge da branch na main primeiro.
Para excluir uma branch:
  1. Abra seu app no editor do app.
  2. Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
  3. Clique no ícone Mais ações ao lado da branch que deseja excluir.
  4. Clique em Excluir.
  5. Revise a confirmação e depois clique em Excluir branch.
O menu de branches com o menu More actions aberto em uma branch, mostrando Merge to main, Update from main e Delete

Abrindo o menu More actions em uma branch

Você pode excluir uma branch depois que a IA terminar de construir nela e qualquer atualização da main estiver concluída. Branches com merge feito permanecem na sua lista como um registro do trabalho.

Perguntas frequentes

Encontre respostas para perguntas comuns sobre branches.
Não há um limite definido. Você pode manter quantas branches quiser ao mesmo tempo e fazer o merge de cada uma quando estiver pronta.
Sim. Cada colaborador pode abrir uma branch diferente e conversar lá, e cada branch faz build por conta própria. Seu app executa vários builds ao mesmo tempo. Se houver mais esperando, cada um aguarda na fila da sua branch e começa assim que outro build termina.Criar uma branch exige acesso de edição ao app, então membros com a função Visualizador podem abrir branches e ler seus chats. Saiba mais sobre funções no seu espaço de trabalho.
Não. Construir em uma branch usa créditos da mesma forma que construir na main, do mesmo saldo de créditos.
Sim. A Base44 adiciona suas branches abertas ao repositório quando você conecta, então não há nada para fazer merge ou excluir antes. Se uma branch estiver em build nesse momento, espere ela terminar e depois conecte.
Sim. Um app que você migrou de outra plataforma funciona com branches pelo mesmo menu de branches que qualquer outro app da Base44.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.