Skip to main content
Traga seu projeto GitHub para a Base44 e continue construindo. Todos na sua equipe podem entregar mudanças reais, e seu repositório continua sendo a fonte da verdade.

Construa de qualquer lugar

Trabalhe no seu projeto pelo desktop ou mobile. A Base44 executa na nuvem, então não há nada para instalar.

Traga sua equipe

Colegas de equipe podem fazer alterações no código com o chat da IA, mesmo que não executem código localmente.

Mantenha seu fluxo do GitHub

Cada alteração é salva em uma branch do seu repositório, e você abre um pull request quando o trabalho estiver pronto.

Vários modelos de IA

Use qualquer modelo de IA disponível na Base44, sem gerenciar assinaturas separadas.

​
Importando seu projeto

Importe um repositório da sua conta GitHub conectada ou cole uma URL de repositório. A Base44 verifica, cria o projeto, clona o código, configura e inicia a prévia. Conecte sua conta GitHub para salvar seu trabalho.
O menu de mais aberto na página inicial da Base44, com Bring your own project em GitHub project

Trazendo seu projeto GitHub para a Base44

Antes de começar:
  • Você precisa ser dono, admin ou editor no workspace da Base44 para onde quer importar o projeto.
  • Seu projeto roda como um serviço web na Base44, então seu repositório deve ser um app web ou full-stack que possa ser construído e executado a partir do código-fonte no Docker, como um frontend com uma API ou um site renderizado no servidor.
  • Para repositórios privados, instale o Base44 GitHub App para que ele possa acessar o repositório.
  • Seu workspace pode limitar os Editors a importar repositórios de organizações GitHub aprovadas. Se um repositório não estiver em uma organização aprovada, peça a um dono ou admin do workspace para adicioná-la em Settings > Governance > GitHub organizations. Donos e admins do workspace podem importar de qualquer organização GitHub.

​
Da sua conta GitHub

Importe diretamente de um repositório na sua conta GitHub conectada. Se você não é dono do projeto, cole um link e a Base44 cria uma cópia que você é dono. Para importar da sua conta GitHub:
  1. Na página inicial da Base44, clique no ícone + na caixa de prompt.
  2. Clique em Bring your own project.
  3. Conecte sua conta GitHub se ainda não estiver conectada.
  4. Escolha o repositório para importar.
  5. Clique no menu Branch para selecionar uma branch inicial. A Base44 usa sua branch padrão se você não escolher uma.
  6. Clique em Import.
O diálogo Import an existing project com um repositório selecionado e o menu Branch definido como main

Importando um projeto da sua conta GitHub

​
De uma URL de repositório

Cole uma URL de repositório GitHub para importar um repositório, público ou privado. A Base44 verifica seu acesso a ele e depois o importa diretamente ou cria uma cópia na sua conta GitHub primeiro. Quando o original é privado, sua cópia também é privada. Para importar de uma URL de repositório:
  1. Na página inicial da Base44, clique no ícone + na caixa de prompt.
  2. Clique em Bring your own project.
  3. Clique em Paste a link.
  4. Cole o link para o repositório GitHub.
  5. Escolha com base no seu acesso:
    • Branch: Selecione uma branch inicial se você pode fazer push para o repositório.
    • Your copy on GitHub: Insira um nome para a cópia que a Base44 cria se você não pode fazer push para o repositório, depois escolha sua visibilidade:
      • Fork (public): Vinculado ao original, para que você possa enviar suas alterações de volta a ele.
      • Private copy: Apenas você pode ver e editar, e não está vinculado ao original.
  6. Clique em Import. Se estiver criando uma cópia, clique em Fork and Import ou Copy and Import.
A aba Paste a link do diálogo Import an existing project, com uma URL de repositório colada, um nome para a cópia e Fork (public) selecionado

Importando um projeto de uma URL de repositório

​
Trabalhando no seu projeto

Quando a importação do seu projeto estiver concluída, continue construindo com o chat da IA e veja suas alterações em Preview. Alterne para Dashboard para navegar em seus arquivos em Code e gerenciar os valores que seu projeto precisa para rodar em Secrets.
O editor do app para um projeto importado com o chat da IA da Base44 e o app rodando em Preview à direita

Um projeto importado rodando no editor do app

​
Salvando seu trabalho

A Base44 salva seu trabalho à medida que você avança. Quando você importa, ela cria sua própria branch de configuração chamada base44/setup- seguida por um ID curto, e roda a configuração lá. A partir daí, ela commita e faz push para a branch em que você está trabalhando toda vez que o chat da IA termina uma alteração. Branches que você cria depois recebem nomes curtos e descritivos, como dark-mode-toggle. Sua branch padrão nunca é tocada. Se você importou um repositório público sem conectar o GitHub, seu app roda em modo local. Nada é commitado ou enviado, e Create PR é desabilitado. Edições que você faz por conta própria em Code são commitadas na próxima vez que o chat da IA terminar uma alteração. Um projeto importado usa as branches git no seu repositório diretamente, então git continua sendo a fonte da verdade. Branches funcionam da mesma forma que em qualquer app Base44, com algumas diferenças. Não há merge ou atualização da sua branch padrão dentro da Base44, todas as branches compartilham uma sandbox, e excluir uma branch na Base44 deixa a branch no GitHub. Consulte trabalhando com branches.

​
Adicionando segredos

Quando seu projeto precisa de uma chave de API ou outro segredo para rodar, o chat da IA pede a você. Dê o valor, e a Base44 o armazena criptografado e o aplica toda vez que seu projeto inicia, incluindo após uma reconstrução. Ele nunca é commitado no seu repositório e é compartilhado entre todas as branches, então você o insere apenas uma vez. Você também pode adicionar e gerenciar segredos no dashboard do seu app. Para adicionar um segredo:
  1. Vá até o dashboard do seu app.
  2. Clique em Secrets.
  3. Clique em Add Secret.
  4. Insira o Secret Name e Secret Value, depois clique em Add Secret.
Para adicionar segredos em massa, clique em Import .env, depois faça upload ou cole seu arquivo. Cada linha KEY=VALUE se torna um segredo, e qualquer segredo existente com o mesmo nome é sobrescrito.

​
Entregando seu trabalho

Cada alteração é commitada por base44-builder[bot]. Uma branch compartilhada produz um pull request para toda a equipe, e branches separadas recebem cada uma o seu próprio. Colegas de equipe com acesso de editor compartilham o projeto e seus segredos.

​
Abrindo um pull request

O pull request vai da sua branch de trabalho para a branch a partir da qual foi criada, com uma nota creditando a Base44 e um link de volta para seu projeto. O pull request de configuração sempre vai para a branch que você importou. Uma vez que o pull request esteja aberto, suas alterações continuam sendo salvas na mesma branch para que os revisores sempre vejam seu trabalho mais recente e quaisquer verificações rodem novamente em cada push. Para abrir um pull request:
  1. Clique em Create PR no topo do editor.
  2. Insira um Title e uma Description (optional).
  3. Clique em Create PR.
Você também pode pedir ao chat da IA um pull request, e ele redige o título e a descrição para você.
Se você ainda não concedeu permissões, clique em Review permissions on GitHub e peça a um dono da conta para aprová-lo.

​
Respondendo aos comentários de revisão

Lide com o feedback dos seus revisores pelo chat da IA, sem sair da Base44. Peça ao chat da IA os comentários de revisão do seu pull request, e ele lista cada thread não resolvida com o arquivo e a linha para os quais aponta. Diga a ele o que alterar, e ele redige uma alteração e uma resposta para cada um. Nada é postado no GitHub até que você aprove aquele rascunho específico. Resolver a thread é uma etapa separada que você solicita. Você também pode pedir a ele para comentar no próprio pull request. Tudo que ele posta aparece como base44-builder[bot]. O merge acontece no GitHub, exatamente como acontece hoje.

​
Perguntas frequentes

Não. A Base44 faz push para a branch em que você está trabalhando, nunca para sua branch padrão. Abrir um pull request é a única forma de suas alterações chegarem à sua branch padrão.
Seu projeto pausa quando você para de trabalhar e retoma de onde parou quando você retorna. Se precisar ser reconstruído, a Base44 clona seu repositório novamente e reinicia a partir do seu commit mais recente.
Sim, a menos que seu workspace limite imports a organizações GitHub aprovadas. Quando você só tem acesso de leitura, a Base44 cria uma cópia na sua conta pessoal do GitHub. Workspaces restritos bloqueiam essa cópia porque ela pertence à sua conta pessoal, em vez de uma organização aprovada. Peça acesso de push ao repositório original.
Seu workspace não permite imports da organização GitHub deste repositório. Peça a um dono ou admin do workspace para adicionar a organização em Settings > Governance > GitHub organizations, depois tente novamente.
Você pode quando o app na raiz do repositório é um app web ou full-stack. A Base44 olha para a raiz para decidir o que é o seu projeto.
Não. A Base44 executa apenas projetos web e full-stack. Você recebe uma mensagem assim que importa, e nada é criado na sua conta. Um repositório com um app web na raiz ainda funciona mesmo se contiver um app mobile em uma subpasta.
Não. Importar um app Base44 não é suportado, e ele não rodará corretamente. Seu app já roda na Base44, e a integração com GitHub o mantém sincronizado com seu repositório nas duas direções.
Não. Um projeto importado não tem páginas, entidades, login integrado ou SDK da Base44. Ele mantém seu próprio banco de dados, autenticação e roteamento, e a Base44 não os substitui.
Sim. Peça ao chat da IA e a Base44 escreve o código no seu repositório, da mesma forma que faz qualquer outra alteração. Você está construindo em sua própria stack, não em páginas, entidades ou login da Base44, então aponte seu projeto para seu próprio banco de dados ou serviço e adicione a string de conexão ou chave de API como um segredo. O que você adicionar é entregue pelo seu repositório como o resto do seu trabalho.
Não. Selecionar um elemento na prévia para editá-lo não está disponível em projetos importados. Diga ao chat da IA o que quer alterar. Ele pode ver a página que você está olhando.
A integração com GitHub sincroniza um app que você construiu na Base44 com um repositório. Importar funciona ao contrário, começando de um repositório que já existe. Para mover um projeto de outra plataforma como Shopify ou Lovable, consulte migrando um projeto para a Base44. Para vincular um projeto de backend Base44 local com a CLI, consulte vinculando um projeto existente.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.