> ## Documentation Index
> Fetch the complete documentation index at: https://vibewax.be/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Faça backup e sincronize seu projeto do Vibewax com o GitHub

A integração do Vibewax com o GitHub conecta seu projeto a um repositório privado no GitHub. Faça backup do seu código, sincronize alterações nos dois sentidos e retome seu projeto em um novo chat sempre que precisar.

## Por que conectar o GitHub

- **Faça backup do seu projeto em um repositório privado.** Seu código fica em um repositório do GitHub que pertence a você.
- **Envie atualizações para o GitHub.** Mande a versão mais recente do Vibewax para o repositório como um pull request que você mesmo mescla.
- **Traga as alterações de volta para o projeto.** Restaure seu projeto a partir da versão armazenada no GitHub.
- **Importe um projeto do GitHub.** Comece um novo projeto no Vibewax a partir de um repositório que você enviou antes.

## Conecte o GitHub ao seu projeto

<Steps>
  <Step title="Abra as configurações do projeto">
    No seu projeto, clique em **Configurações** na barra superior e abra a aba **Geral**.
  </Step>
  <Step title="Crie o repositório">
    Role até **Conexão ao GitHub** e clique em **Criar no GitHub**. Na primeira vez, você vai autorizar o Vibewax no GitHub e escolher qual conta ou organização do GitHub conectar. Escolha uma em que o app já esteja instalado ou selecione **Install on another GitHub account**. Em seguida, o Vibewax cria um repositório privado e sincroniza seu projeto nele.

    <img src="https://vibewax.be/docs/images/integrations_github_create.png" alt="Botão Criar no GitHub na seção Conexão ao GitHub da aba Geral das configurações" width="1500" height="1000" />
  </Step>
  <Step title="Seu repositório está vinculado">
    A seção agora mostra o nome do seu repositório com um link para abri-lo no GitHub. A partir daí, você pode enviar e receber alterações.
  </Step>
</Steps>

## Envie e receba alterações

Depois que o repositório estiver vinculado, a seção **Conexão ao GitHub** mostra dois botões:

- **Fazer push** envia a versão mais recente do Vibewax para o GitHub. O Vibewax abre um pull request com o título "Updates from Vibewax", que você revisa e mescla no GitHub.
- **Fazer pull** substitui os arquivos do seu projeto pela versão do GitHub. O Vibewax pede sua confirmação antes. Seus arquivos `.env` e `.env.local` são sempre mantidos.

Para desvincular o repositório, clique no botão `X` ao lado do nome dele.

## Importe um projeto do GitHub

Você pode começar um novo projeto no Vibewax a partir de um repositório que você enviou antes pelo Vibewax.

<Steps>
  <Step title="Ative a ação de importação">
    Abra **Preferências** nas configurações da sua conta, role até **Avançado** e ative **Importar do GitHub**. Isso exibe a ação na tela inicial.

    <img src="https://vibewax.be/docs/images/integrations_github_import.png" alt="Opção Importar do GitHub em Preferências, na seção Avançado" width="1500" height="1000" />
  </Step>
  <Step title="Abra Importar do GitHub">
    Na tela inicial, abra o menu **+** na barra de prompt e escolha **Importar do GitHub**.
  </Step>
  <Step title="Escolha um repositório">
    Pesquise o repositório e selecione-o. O Vibewax cria um novo projeto a partir dele. Use **Configurar** para reconectar o GitHub ou trocar de conta e **Atualizar** para recarregar a lista. Você só vê os repositórios aos quais sua conta do GitHub tem acesso.
  </Step>
</Steps>

<Note>
  A importação funciona com repositórios criados pelo Vibewax. Importar um repositório externo, que não seja do Vibewax, não é compatível.
</Note>

## O que é sincronizado

Os arquivos do projeto, componentes, páginas, estilos, recursos e a configuração do Vibewax são incluídos. Variáveis de ambiente (arquivos `.env`) e arquivos de cache nunca são enviados, e o pull nunca sobrescreve seus `.env` e `.env.local`.

## Bom saber

- **Os repositórios são sempre privados.** O Vibewax nunca torna seu código público.
- **Uma conta gratuita do GitHub funciona.** Você não precisa de um plano pago do GitHub.
- **O push abre um pull request** que você mescla no GitHub. Ele não altera seu site publicado.
- **O pull substitui os arquivos do projeto**, mas mantém seus `.env` e `.env.local`.


This page is part of the [Vibewax documentation](https://vibewax.be/docs/pt-BR/welcome/overview).