> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Trazendo seu próprio projeto do GitHub
> Traga seu próprio projeto do GitHub e continue construindo na Base44.
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.
Trabalhe no seu projeto pelo desktop ou mobile. A Base44 executa na nuvem, então não há nada para instalar.
Colegas de equipe podem fazer alterações no código com o chat da IA, mesmo que não executem código localmente.
Cada alteração é salva em uma branch do seu repositório, e você abre um pull request quando o trabalho estiver pronto.
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.
**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](#from-a-repository-url) e a Base44 cria uma cópia que você é dono.
**Para importar da sua conta GitHub:**
1. Na [página inicial da Base44](https://app.base44.com), 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**.
### 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](https://app.base44.com), 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**.
***
## 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**.
### 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](/Building-your-app/Working-with-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](/developers/app-code/local-development/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](/developers/app-code/local-development/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](/Getting-Started/migrating-an-existing-app). Para vincular um projeto de backend Base44 local com a CLI, consulte [vinculando um projeto existente](/developers/backend/overview/link-existing-project).
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](/).