Skip to main content
O Base Code oferece à sua equipe um ambiente compartilhado na nuvem para um código existente. Você não precisa configurar um ambiente de desenvolvimento local. Use o chat de IA para fazer alterações em branches, visualizar seu trabalho e abrir pull requests para revisão. O GitHub continua sendo a fonte da verdade.
O Base Code fazendo uma alteração pelo chat de IA em uma branch de trabalho, com os arquivos do projeto e o Preview sendo atualizados

Fazendo uma alteração pelo chat de IA

Antes de começar:
  • Seu projeto precisa ser um projeto web ou full-stack em um repositório do GitHub.
  • Você precisa ter a função de Editor ou superior no workspace.
  • Você precisa conectar uma conta do GitHub durante a configuração.

​
Configurando o Base Code

Conecte um repositório do GitHub para fazer alterações com o chat de IA no Base Code. Se sua conta do GitHub já estiver conectada, continue para escolhendo um repositório.

​
Conectando sua conta do GitHub

O Base Code trabalha diretamente nos seus repositórios do GitHub, então precisa de acesso aos repositórios em que você quer trabalhar. Para conectar sua conta:
  1. Acesse o Base Code.
  2. Clique em Connect GitHub.
  3. Entre no GitHub, se solicitado, e autorize o Base44 Builder.
  4. Selecione a conta ou organização do GitHub. Depois, siga as instruções para instalar ou configurar o Base44 Builder e dar acesso aos repositórios.

​
Escolhendo um repositório

Escolha o código em que você quer trabalhar, entre seus próprios repositórios ou uma cópia de um repositório em que você não pode fazer push.
Para escolher um repositório da sua conta:
  1. No Base Code, clique em View more.
  2. Selecione um repositório.
  3. Em Branch, mantenha a branch selecionada ou selecione outra.
  4. Clique em Connect.
Outras formas de abrir um repositório:
  • Abrir um repositório listado: Selecione-o na página do Base Code e clique em Open in Base. Ele abre na branch padrão.
  • Conectar outro repositório: Clique no menu suspenso de repositórios na barra lateral e depois em Add repository. No celular, o menu suspenso de repositórios da página do Base Code chama essa opção de Add new repository. As duas opções abrem Connect your repository.

​
Trabalhando no seu projeto

Use o chat de IA para fazer alterações no repositório conectado e testá-las em uma visualização de desenvolvimento. Conforme você conversa, o Base Code faz commit e push das suas alterações para sua branch de trabalho no GitHub.
O Base Code oferece uma visualização de desenvolvimento, não hospedagem de produção. Para lançar suas alterações ou conectar um domínio personalizado, use o processo de implantação atual e o provedor de hospedagem do seu projeto.

​
Fazendo sua primeira alteração

O Base Code cria uma nova branch a partir do seu primeiro pedido e dá um nome a ela. Assim, sua alteração fica separada até você abrir um pull request. Para continuar trabalhando em uma branch existente do GitHub, importe-a. Para fazer sua primeira alteração:
  1. Acesse o Base Code.
  2. (Opcional) Se aparecer um menu suspenso ao lado de Create new branch, selecione a branch de origem.
  3. Na caixa de prompt, descreva a alteração que você quer fazer. Por exemplo:
  4. Clique em Create branch para abrir a nova branch e começar a fazer alterações.
  5. Revise a alteração em Preview e peça ajustes ao chat de IA, se necessário.

​
Revisando suas alterações

Confira exatamente o que mudou antes de pedir a alguém para revisar. Para revisar suas alterações:
  1. Abra as alterações que você quer conferir:
    • Alterações de uma resposta: Use a lista de arquivos abaixo dessa resposta no chat de IA.
    • Todas as alterações da branch: Clique em Create PR no topo do editor ou clique no número do PR, se já existir um.
  2. Clique no nome de um arquivo para ver o diff, com as linhas adicionadas e removidas.

​
Revertendo um arquivo

Desfaça as alterações que você não quer em um arquivo. A reversão é salva como um novo commit na sua branch.
Reverter um arquivo desfaz todas as alterações com commit nele na branch, não apenas as alterações de uma resposta.
Para reverter um arquivo:
  1. Clique no ícone de reverter ao lado do arquivo em qualquer uma das listas de arquivos, inclusive na de um pull request aberto.
  2. Confira se o arquivo certo aparece em Revert branch changes? e clique em Revert.

​
Gerenciando branches

As branches permitem trabalhar em várias alterações ao mesmo tempo sem que uma afete a outra. Cada branch tem seu próprio ambiente de desenvolvimento no Base Code e seu próprio pull request.
A barra lateral de branches está disponível no desktop. No celular, use o menu suspenso de branches.

​
Trabalhando pela barra lateral

Veja a situação de cada uma das suas branches e vá direto para a que precisa de você. Your branches na barra lateral lista as branches que você criou. As branches mescladas continuam na lista, então você ainda pode ler os chats delas. Cada branch tem um ícone de status. Passe o mouse sobre ele para ver o rótulo, com o número do pull request quando houver um. Enquanto a IA está construindo, o ícone é substituído por Working, e por Merging enquanto um merge é executado. Um ponto à direita de uma branch indica que a IA terminou ali e você ainda não a abriu desde então. Para abrir uma branch, clique nela em Your branches. Você também pode clicar no menu suspenso de branches acima do chat de IA e selecionar uma branch.

​
Organizando suas branches

Mantenha à mão as branches em que você está focado e leve para o topo as que precisam de você.
Your branches com uma branch fixada no topo e um grupo expandido abaixo dela

Uma branch fixada acima de um grupo em Your branches

Para fixar uma branch:
  1. Passe o mouse sobre a branch na barra lateral e clique no ícone de opções .
  2. Clique em Pin.
As branches fixadas ficam no topo de Your branches, acima dos seus grupos. Para desafixar uma, clique em Unpin no mesmo menu. Para agrupar branches:
  1. Clique no ícone New group ao lado de Your branches.
  2. Insira um Group name e clique em Create group.
  3. Arraste uma branch para o grupo ou clique no ícone de opções da branch, clique em Move to group e selecione o grupo.
Para tirar uma branch do grupo, arraste-a para Your branches ou clique no ícone de opções , clique em Move to group e depois em Remove from group. O ícone de opções do próprio grupo tem Rename group e Delete group. Para ordenar branches:
  1. Clique no ícone Sort branches ao lado de Your branches.
  2. Em Sort by, selecione uma das opções:
    • Priority: Primeiro as branches que precisam de você, depois as que estão em espera.
    • Last updated: As trabalhadas mais recentemente primeiro. Esta é a opção padrão.
    • Manual order: A ordem que você definiu arrastando.
O menu Sort by aberto na barra lateral do Base Code com Priority selecionado

Ordenando Your branches por Priority

Organizando branches manualmente: Arraste uma branch para colocá-la onde quiser. A lista muda para Manual order e mantém sua organização até você ordená-la de outra forma. Você também pode arrastar grupos para reordená-los.

​
Criando branches

Comece cada nova alteração em uma branch própria, a partir da branch padrão ou de outra branch em que você está trabalhando. Para criar uma branch pela barra lateral:
  1. Clique em New branch na barra lateral.
  2. Descreva sua alteração no chat de IA e envie a mensagem.
A barra lateral do Base Code com New branch destacado, acima de Home e Your branches

Iniciando uma branch pela barra lateral

A barra lateral dá um nome à branch e a cria a partir da branch padrão do seu repositório. Para começar de outra branch, use o menu suspenso de branches. Para criar uma branch pelo menu suspenso de branches:
  1. Clique no menu suspenso de branches acima do chat de IA.
  2. Clique em Create new branch.
  3. Selecione a branch de origem no menu suspenso ao lado de Start from.
  4. Descreva sua alteração no chat de IA e envie a mensagem.

​
Importando uma branch do GitHub

Importe uma branch existente do GitHub para continuar trabalhando nela no Base Code. Suas alterações recebem commit e push nessa branch. Para importar uma branch:
  1. Clique no menu suspenso de branches acima do chat de IA.
  2. Clique em Import from GitHub.
  3. Selecione a branch.
  4. Clique em Import.

​
Excluindo uma branch

Remova as branches que você não usa mais, junto com os chats delas. As branches continuam no GitHub. Para excluir uma branch:
  1. Abra o menu da branch em um destes lugares:
    • Na barra lateral, passe o mouse sobre a branch e clique no ícone de opções .
    • No menu suspenso de branches acima do chat de IA, clique em More actions ao lado da branch.
  2. Clique em Delete.
  3. Clique em Delete branch para confirmar.

​
Trabalhando com pull requests

Faça a revisão e o merge das suas alterações por meio de pull requests no GitHub. O Base Code sempre usa sua própria conexão com o GitHub, independentemente do que seu workspace define para os outros aplicativos. Sua conta do GitHub precisa estar conectada e ter acesso de escrita ao repositório. A Base44 abre pull requests pela sua conta. Cada commit do chat de IA mostra você como autor e base44-builder[bot] como coautor.

​
Abrindo um pull request

Depois de testar suas alterações, abra um pull request para revisão. Seu pull request aponta para a branch a partir da qual sua branch de trabalho foi criada. O chat de IA escreve o título e a descrição com base na sua conversa e nas alterações com commit. Para abrir um pull request pelo topo do editor:
  1. Clique em Create PR no topo do editor.
  2. Revise os arquivos alterados em Create pull request.
  3. Clique em Continue in builder.
  4. Revise e envie a mensagem pré-preenchida no chat de IA.
Abrindo um pull request pelo menu suspenso de branches: O menu suspenso abre um formulário mais curto para o título e a descrição, sem a revisão dos arquivos.

​
Acompanhando seus pull requests

Acompanhe o andamento dos seus pull requests abertos e veja quais precisam da sua atenção. Para acompanhar seus pull requests:
  1. Acesse o Base Code.
  2. Em Your open PRs, escolha o que você quer fazer:
    • Abrir um pull request: Clique no número do PR para abri-lo no GitHub ou clique no título para abrir a branch dele no Base Code.
    • Filtrar por status: Clique no filtro e selecione All, In review, Conflicts ou Open.
    • Encontrar um pull request: Clique no ícone de busca e insira o título ou o número dele.
    • Ordenar pull requests: Clique em Sort para inverter a ordem por número do pull request.
  • Draft: Ainda é um rascunho no GitHub.
  • Open: Ainda não há revisor e nada está bloqueando.
  • In review: Um revisor foi atribuído ou solicitou alterações.
  • Approved: Um revisor aprovou.
  • Conflicts: Sua branch tem conflitos a resolver com a branch base.

​
Resolvendo conflitos de branch

Se seu pull request tiver conflitos, o chat de IA pode resolvê-los para você. Resolver conflitos faz o merge da branch base do pull request na sua branch de trabalho. Para resolver conflitos:
  1. Clique em Resolve conflicts acima da caixa de prompt.
  2. Revise e teste as alterações feitas pela IA, principalmente onde as duas branches alteraram o mesmo recurso.

​
Respondendo a comentários de revisão

Use o chat de IA para tratar o feedback do seu pull request. Para responder a comentários de revisão:
  1. Peça ao chat de IA para listar os comentários não resolvidos do seu pull request. Ele inclui o arquivo e a linha de cada thread.
  2. Diga quais comentários tratar e o que alterar.
  3. Revise as alterações e respostas propostas antes de pedir que ele as publique.
  4. Peça separadamente ao chat de IA para resolver uma thread quando estiver pronto.

​
Adicionando segredos

Dê ao seu projeto as chaves de API e outras credenciais de que ele precisa sem colocá-las no seu repositório. O chat de IA avisa quando um segredo é necessário. Os segredos são criptografados, compartilhados entre as branches e mantidos quando seu ambiente é reconstruído. Alterações e remoções são aplicadas automaticamente às branches em execução. As branches inativas as recebem na próxima vez que você as abrir. Para adicionar um segredo:
  1. Clique em Dashboard no topo do editor.
  2. Clique em Secrets.
  3. Clique em Add Secret.
  4. Insira o Secret Name e o Secret Value e clique em Add Secret.
Adicionando segredos em massa: Clique em Import .env e envie ou cole seu arquivo. Cada linha KEY=VALUE vira um segredo. Um segredo existente com o mesmo nome é substituído.

​
Colaborando com colegas de equipe

Sua equipe pode contribuir com o mesmo projeto e revisar as alterações uns dos outros por meio de pull requests. Qualquer pessoa com função de Editor ou superior no workspace pode abrir um projeto existente do Base Code sem um convite separado para o aplicativo. Para convidar alguém de fora do seu workspace, adicione a pessoa como colaboradora pelo editor do aplicativo.

​
Perguntas frequentes

O Base Code funciona com projetos web e full-stack. Se você está criando seu aplicativo na Base44, continue no editor do aplicativo e use a integração com o GitHub para sincronizá-lo com um repositório.
O Base Code verifica o projeto na raiz do seu repositório. Esse projeto precisa ser web ou full-stack. Um aplicativo mobile em uma subpasta não é problema, desde que o projeto da raiz atenda aos requisitos.
Na página do Base Code, clique em View more, ou em Add repository no menu suspenso de repositórios da barra lateral, para abrir Connect your repository. Se o repositório ainda não aparecer, dê à Base44 acesso a ele no GitHub.Para atualizar o acesso ao repositório:
  1. No GitHub, dê ao Base44 Builder acesso ao repositório.
  2. Abra novamente Connect your repository no Base Code.
Seu workspace não permite repositórios dessa organização do GitHub. Peça a quem gerencia as configurações do GitHub do seu workspace para verificar se a organização está conectada e marcada como Allowed em Build tools > GitHub. Depois, tente novamente.Se você tem apenas acesso de leitura, conecte um fork ou uma cópia privada. Quando seu workspace limita os repositórios a organizações aprovadas, você precisa de acesso de escrita a um repositório em uma delas.
As configurações do workspace controlam quem pode conectar organizações do GitHub e quais organizações ficam disponíveis para novos aplicativos. Qualquer pessoa no workspace pode usar uma organização que já está conectada. Esta configuração só controla quem pode adicionar uma nova.Para gerenciar as organizações do GitHub:
  1. Acesse as configurações do seu workspace.
  2. Em Build tools, clique em GitHub.
  3. Escolha o que você quer fazer:
    • Escolher quem pode conectar organizações: Em Who can connect organizations, selecione quem pode adicionar uma organização.
    • Filtrar organizações: Em Connected organizations, use o filtro para mostrar organizações All, Active ou Disconnected.
    • Disponibilizar uma organização para novos aplicativos: Em Connected organizations, use Allowed para controlar quais organizações ficam disponíveis. Alterar Allowed não afeta os aplicativos que já usam essa organização.
    • Desconectar uma organização: Clique no ícone de ações ao lado da organização, clique em Disconnect organization e depois em Disconnect.
Ao desconectar, os aplicativos ligados à conexão do workspace dessa organização param de sincronizar com o GitHub. A confirmação lista os aplicativos afetados. O Base44 Builder continua instalado no GitHub, então você pode reconectar a organização.
Sim. Por padrão, o Base Code usa o Auto mode para escolher um modelo de IA para cada pedido.Para escolher um modelo de IA:
  1. Clique no modelo na parte inferior do chat de IA.
  2. Selecione o modelo com o qual você quer trabalhar.
Para mais detalhes, veja escolhendo um modelo de IA.
Sua conta do GitHub precisa estar conectada e ter acesso de escrita ao repositório. Caso contrário, o projeto mostra o selo Read only. Você pode discutir o projeto no chat de IA e trocar de branch, mas não pode fazer alterações nem criar uma branch.Para conectar sua conta do GitHub:
  1. Abra o projeto.
  2. No banner Connect your GitHub account, clique em Connect account.
  3. Autorize o Base44 Builder no GitHub.
Se você vir GitHub write access required, sua conta está conectada, mas não tem acesso de escrita. Peça a um administrador do repositório para concedê-lo e clique em Recheck permissions.
Quando você volta ao Base Code, o ambiente do seu projeto é iniciado novamente para você continuar trabalhando. Se o ambiente precisar ser reconstruído, o Base Code usa o commit mais recente da sua branch no GitHub. Antes de sair, peça ao chat de IA para confirmar que suas últimas alterações estão nessa branch.
Sim. Peça ao chat de IA para adicionar o código usando a stack do seu projeto.Conectar um repositório não adiciona nem configura automaticamente entidades, login ou o SDK da Base44. Seu projeto mantém o banco de dados, a autenticação e o roteamento que já tem.Para um novo banco de dados ou serviço, adicione a string de conexão ou a chave de API como um segredo.
Se forem necessárias alterações de configuração e você conectou a branch padrão, o Base Code cria uma branch de configuração e faz o commit nela. O pull request dela aponta para a branch que você conectou. Se você conectou outra branch, o Base Code faz o commit das alterações de configuração diretamente nessa branch.Para incluir alterações de configuração ainda não mescladas em uma nova branch, comece pela branch que contém essas alterações.
Depois que você abre um pull request, as novas alterações na sua branch de trabalho são adicionadas a ele, e o GitHub executa as verificações configuradas no seu repositório.Faça o merge do seu pull request no GitHub ou peça ao chat de IA para fazer o merge.
A Base44 precisa de permissão para abrir pull requests no seu repositório. Se solicitado, clique em Review permissions on GitHub. Um proprietário da conta ou organização do GitHub dona do repositório precisa aprovar o acesso solicitado. Depois da aprovação, volte ao Base Code e tente novamente.
Veja a Política de Privacidade da Base44 para saber como as informações pessoais são coletadas e usadas. Para informações sobre o treinamento de modelos de IA e seus controles de dados, veja Privacidade e segurança.
Você pode aplicar um cupom antes ou depois de conectar um repositório.Cada código de cupom vale para até 10 pessoas no seu workspace.Para aplicar um cupom:
  1. Acesse o Base Code.
  2. Insira seu código de cupom:
    • Antes de conectar um repositório: Clique em Have a coupon? no canto superior direito e insira seu código na caixa de diálogo.
    • Depois de conectar um repositório: Insira seu código no campo abaixo de Have a coupon?.
  3. Clique em Apply.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.