
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: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.Iniciando uma nova branch
Inicie uma branch pelo menu de branches quando tiver uma nova ideia para construir. Para criar uma branch:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Clique em Criar novo branch.
- Digite o que deseja construir na caixa de chat.
- Envie a mensagem.

Criando sua primeira branch pelo menu de branches
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. Para criar uma branch privada:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Clique em Criar novo branch.
- Selecione Branch privado no topo da caixa do chat.
- Digite o que deseja construir na caixa do chat.
- Envie a mensagem.

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:- Abra seu app no editor do app.
- Passe o cursor sobre uma mensagem que você enviou no chat principal.
-
Clique no ícone Criar branch a partir daqui abaixo dela.

O ícone Branch from here abaixo de uma mensagem que você enviou
- 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.- 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.
- Confira a sugestão Criar novo branch no chat de IA. Ela mostra o que a IA construiria na nova branch.
- 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.

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:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Clique em Importar do GitHub.
- Pesquise a branch que deseja e selecione-a.
- Clique em Importar.
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.

Trabalhando em uma branch, com Merge to main no lugar de Publish
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:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Selecione uma branch na lista, ou selecione Chat principal para voltar à main.

Alternando entre a main e suas branches
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:- Abra seu app no editor do app.
-
Passe o cursor sobre o avatar de um colaborador no topo do editor do app para ver o nome e a branch dele.

O avatar de um colaborador mostrando em qual branch ele está
- 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
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:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Selecione sua branch.
- Clique em Pré-visualização.
- Clique no ícone Ativar dados de teste no topo da prévia.
- 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.
- Remove uma entidade ou um campo.
- Altera o tipo de um campo existente, ou se ele é obrigatório.
- Altera permissões de dados.
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.
- 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 em uma branch, mostrando os arquivos da própria branch
- 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.
- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
- Clique no ícone Histórico de versões no topo do painel de chat.
- Clique em uma versão na lista para carregá-la na prévia.
- Clique no ícone Mais opções ao lado dessa versão.
- Clique em Voltar para esta versão.

Restaurando uma versão anterior 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:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
- Clique no ícone Histórico de versões no topo do painel de chat.
- Clique no ícone Mais opções ao lado da versão que deseja comparar.
-
Clique em Comparar código com main.

Comparando uma versão da branch com a main
-
Clique em um arquivo na lista para ver o que mudou nele.

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:- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
- Clique em Atualizar branch no card de atualização acima da caixa de chat.

O card de atualização que aparece acima da caixa de chat quando a main mudou
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.
- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA, e selecione a branch.
- Clique em Mesclar no main abaixo da resposta mais recente da IA ou no topo do editor.
- Revise a confirmação e depois clique em Mesclar no main.

Clique em Merge to main no topo do editor e depois publique da main quando estiver pronto
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.- Abra seu app no editor do app.
- Clique em Principal, ou no nome da branch em que você está, no topo do chat de IA.
- Clique no ícone Mais ações ao lado da branch que deseja excluir.
- Clique em Excluir.
- Revise a confirmação e depois clique em Excluir branch.

Abrindo o menu More actions em uma branch
Perguntas frequentes
Encontre respostas para perguntas comuns sobre branches.Quantas branches posso ter?
Quantas branches posso ter?
Minha equipe e eu podemos trabalhar em branches diferentes ao mesmo tempo?
Minha equipe e eu podemos trabalhar em branches diferentes ao mesmo tempo?
Branches usam créditos extras?
Branches usam créditos extras?
Posso conectar meu app ao GitHub enquanto tenho branches?
Posso conectar meu app ao GitHub enquanto tenho branches?
Posso usar branches em um app que migrei para a Base44?
Posso usar branches em um app que migrei para a Base44?