Sincronizar um projeto em código com o GitHub

Para que serve

A sincronização com o GitHub é útil para quem trabalha com um desenvolvedor ou quer uma cópia do código fora da Micronuage. Cada mudança feita aqui vira um commit no repositório, e cada push na branch volta para cá como uma nova versão do projeto.

Ela funciona só em projetos em código; veja Modo código. O botão GitHub aparece no topo do editor quando a integração está disponível.

Conectar um projeto a um repositório

1. 1

   No editor, clique em GitHub, no topo

2. 2

   Clique em Conectar GitHub

   Você vai ao GitHub instalar o app da Micronuage e escolher quais repositórios ele pode acessar. Depois volta para o editor.

3. 3

   Escolha a Conta e o Repositório e clique em Sincronizar

   O código do projeto vira o próximo commit na branch principal do repositório; o histórico dele é mantido.

4. 4

   Ou crie um repositório novo

   Em Ou crie um repositório novo, dê um Nome, marque Privado se quiser e clique em Criar e sincronizar.

Em Opções avançadas, você escolhe outra Branch (vazio é a principal; uma branch nova é criada a partir dela) ou uma Pasta do repositório (vazio é a raiz; por exemplo, apps/site). Se o repositório não aparece na lista, use Escolher quais repositórios o app pode acessar.

Como a sincronização funciona

• Mudou só na Micronuage: as mudanças viram um commit na branch.
• Mudou só no GitHub: o código da branch vira a próxima versão do projeto, com a origem GitHub no histórico.
• Mudou dos dois lados: os arquivos alterados aqui entram por cima do commit do GitHub; um arquivo alterado nos dois lados fica com a versão da Micronuage.
• Nada se perde: toda versão continua no Histórico e todo commit continua no git. A branch só anda para a frente.
• O código que vem do GitHub passa pelas mesmas verificações que o da IA. Se algo falhar, ele é mantido, o problema é avisado e a publicação espera a correção.
• Imagens e outros arquivos binários, e os arquivos de automação do GitHub (workflows), ficam só no repositório.

Com o projeto conectado, o painel mostra Sincronizado com o repositório e a branch, a hora da última sincronização e os botões Sincronizar agora, Abrir no GitHub e Desconectar. Desconectar para a sincronização e não muda nada no repositório.

Importar um repositório como projeto novo

1. 1

   No Painel, clique em Importar do GitHub

2. 2

   Escolha a Conta

   Se ainda não conectou nenhuma, clique em Conectar GitHub. Para outra conta, use Conectar outra conta do GitHub.

3. 3

   Decida sobre Manter sincronizado com o repositório

   Marcado, o projeto novo fica sincronizado com a branch, nos dois sentidos.

4. 4

   Clique em Importar no repositório

   O editor abre com o código importado como versão 1.

A branch principal é importada, a menos que você escolha outra em Opções avançadas. Imagens e outros arquivos binários ficam no repositório. A Micronuage roda projetos em React com Vite; um projeto de outro tipo (Next.js, Vue, HTML…) é importado com um aviso e o botão Adaptar com a IA, que envia um pedido à IA e usa créditos. A importação conta no limite de projetos do plano.

Problemas comuns