Skip to main content
Configure a integração com o GitHub para editar seu app Base44 localmente e sincronizar mudanças automaticamente.

​
Sincronizar seu app com o GitHub

Conecte seu app ao GitHub para escrever código no seu ambiente de desenvolvimento local ou na Base44 e mantê-los sincronizados.
GitHub connection prompt showing permanent sync setup.

Conecte ao GitHub para sincronização bidirecional

Importante:
  • A sincronização bidirecional com GitHub requer o plano Builder ou superior.
  • Apenas proprietários do app podem conectar um app a um repositório ou reconectá-lo.
  • Se você anteriormente conectou ao GitHub usando a integração legada Export to GitHub (unidirecional), clique em Looking for the old setup? no painel do GitHub para desconectá-la e reconectar usando a sincronização bidirecional.
  • Quando você conecta seu app ao GitHub, suas mudanças são sincronizadas automaticamente com o repositório conectado. Não há opção para enviar atualizações manualmente do seu app Base44 para o GitHub.
  • Depois de conectar o GitHub ao seu app, você não pode usar o Version History para reverter para versões anteriores à integração com o GitHub. Essas versões mais antigas não são armazenadas no seu repositório do GitHub, então tentar reverter para elas resulta em erro. Apenas versões que existem no repositório conectado do GitHub estão disponíveis para restaurar.
Para sincronizar seu app com o GitHub:
  1. Clique em Dashboard no editor do seu app.
  2. Clique no ícone do GitHub no canto superior direito e clique em Connect to GitHub.
  3. Clique em Connect GitHub.
  4. Clique em Authorize Base44 Builder.
  5. Escolha onde instalar o Base44 Builder:
    • Selecione a organização ou conta do GitHub.
    • Escolha a quais repositórios permitir acesso.
  6. Clique em Install.
  7. Crie um repositório para seu app:
    • Escolha a organização ou conta do GitHub.
    • Insira um nome para o novo repositório.
    • Clique em Create Repository.
Depois de conectar, clique no ícone do GitHub no painel superior, depois clique em Go to Repository.
GitHub showing Connected status and a Go to Repository button.

Veja seu repositório do GitHub conectado

​
Como sua equipe grava no GitHub

As conexões do GitHub pertencem ao seu workspace, e não à conta de uma pessoa. Os admins do workspace as gerenciam em Workspace settings > GitHub, e a sincronização continua funcionando se o membro que conectou uma organização sair do workspace. O admin do seu workspace escolhe como os membros gravam no GitHub. A configuração se aplica a todos os apps do workspace que sincronizam com o GitHub:
  • Conexão compartilhada: Todos gravam pela conexão do workspace, sem conectar uma conta própria do GitHub. Os commits mostram a Base44 como autora. Esse é o padrão.
  • Conexão por usuário: Cada membro conecta a própria conta do GitHub e recebe o acesso que o GitHub já dá a ele. Membros sem acesso de escrita ao repositório não podem editar nem publicar o app. Os commits aparecem com o nome do próprio membro.
Apps Base Code sempre usam conexões por usuário.
Como as organizações funcionam no seu workspace:
  • Ao criar um repositório, você só vê as organizações do GitHub que seu workspace permite.
  • Por padrão, apenas proprietários e admins do workspace podem adicionar uma nova organização. Os admins também podem permitir que Editors adicionem organizações.
  • As conexões feitas antes de o GitHub passar para o workspace foram migradas automaticamente, então você não precisa reconectar.

​
Configurar seu ambiente de desenvolvimento local

Depois de conectar ao GitHub, configure seu repositório local para começar a editar código no seu ambiente de desenvolvimento preferido. Para configurar seu repositório local:
  1. Clone o repositório usando a URL Git do projeto.
  2. Navegue até o diretório do projeto.
  3. Instale as dependências: npm install.
  4. Instale a CLI da Base44: npm install -g base44@latest.
  5. Autentique-se: base44 login.
  6. Vincule o clone ao seu app: base44 link. O ponteiro de vínculo base44/.app.jsonc está no gitignore, então cada clone novo precisa desta etapa.
Execute o app localmente:
Isso inicia um backend local da Base44 e seu servidor de desenvolvimento do frontend juntos. As solicitações /api do frontend são encaminhadas por proxy ao backend local. Consulte Local development para saber o que roda localmente. Para trabalhar apenas no frontend contra o backend hospedado ao vivo do seu app, execute base44 dev --remote em vez disso.
No modo remoto, as gravações vão para os dados de produção do seu app ao vivo.
Para detalhes sobre a estrutura de arquivos exportada, veja Project Structure.

​
Sincronizar mudanças locais com a Base44

Para sincronizar suas mudanças locais com a Base44, faça merge das mudanças para a branch principal do git. Esta branch deve se chamar main. Outros nomes de branch padrão, como master, atualmente não são suportados. As mudanças então ficarão visíveis no seu app Base44.
Após sincronizar, clique em Publish no canto superior direito do seu app Base44 para tornar as mudanças disponíveis para os usuários.

​
Desconectar do GitHub

Você pode desconectar um app específico do seu repositório do GitHub, ou desconectar uma organização do GitHub de todo o seu workspace. Mover um app para outro workspace também desconecta a sincronização com o GitHub, e a Base44 avisa você antes disso.
Se você não vê Disconnect no painel do GitHub, ele ainda não está habilitado para a sua conta. A sincronização não pode ser pausada, então os únicos estados são conectado e desconectado.

​
Desconectar seu repositório

Desconecte seu app do seu repositório do GitHub se não quiser mais sincronizar mudanças. Apenas o proprietário do app ou o membro que conectou o repositório pode desconectá-lo. Para desconectar seu repositório:
  1. Abra a aba code.
  2. Clique em GitHub.
  3. Clique no ícone More actions .
  4. Clique em Disconnect.
O processo de desconexão leva aproximadamente 30 segundos e só está disponível quando o agente de IA não está fazendo mudanças ativamente no seu app.

​
Reconectar seu repositório

Reconecte seu app ao repositório do qual ele foi desconectado para retomar a sincronização. Apenas o proprietário do app pode reconectar. Para reconectar seu repositório:
  1. Clique no ícone do GitHub no canto superior direito e clique em Connect to GitHub.
  2. Na caixa de diálogo Reconnect Repository, clique em Reconnect.
Quando você não pode reconectar:
  • Tanto seu app quanto o repositório têm novos commits desde a última vez em que estavam iguais.
  • O repositório foi renomeado ou excluído, ou a branch padrão dele mudou.
  • O repositório foi conectado a partir de outro workspace.
  • A conexão do workspace com a organização do repositório foi desconectada. Peça a um admin do workspace para reconectá-la em Workspace settings > GitHub.
Nesses casos, clique em Create a new repository instead.

​
Desconectar uma organização do seu workspace

Desconecte uma organização do GitHub se você não quiser mais que os apps do seu workspace sincronizem com ela. Todos os apps que sincronizam pela organização param de sincronizar, e o Base44 GitHub App continua instalado no GitHub. Proprietários, admins e Editors do workspace podem desconectar uma organização. Para desconectar uma organização:
  1. Vá para Workspace settings.
  2. Clique em GitHub.
  3. Em Connected organizations, clique no ícone More actions ao lado da organização.
  4. Clique em Disconnect organization.
  5. Clique em Disconnect para confirmar.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.