> ## 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

> Faz o backup e sincroniza o teu projeto Vibewax com o GitHub

A integração do GitHub no Vibewax liga o teu projeto a um repositório privado do GitHub. Faz o backup do teu código, sincroniza alterações em ambas as direções e retoma o teu projeto numa novo chat sempre que precisares.

## Porquê ligar o GitHub

- **Faz o backup do teu projeto num repositório privado.** O teu código fica num repositório do GitHub que é teu.
- **Envia atualizações para o GitHub.** Envia a tua versão mais recente do Vibewax para o repositório como um pull request que depois integras.
- **Recupera alterações para o teu projeto.** Restaura o teu projeto a partir da versão guardada no GitHub.
- **Importa um projeto do GitHub.** Inicia um novo projeto Vibewax a partir de um repositório que enviaste anteriormente.

## Liga o GitHub ao teu projeto

<Steps>
  <Step title="Abre as definições do teu projeto">
    No teu projeto, clica em **Definições** na barra superior e depois abre o separador **Geral**.
  </Step>
  <Step title="Cria o repositório">
    Desce até **Ligação ao GitHub** e clica em **Criar no GitHub**. Da primeira vez, vais autorizar o Vibewax no GitHub e escolher que conta ou organização do GitHub queres ligar. Escolhe uma onde a aplicação já esteja instalada ou seleciona **Install on another GitHub account**. O Vibewax cria então um repositório privado e sincroniza o teu projeto com ele.

    <img src="https://vibewax.be/docs/images/integrations_github_create.png" alt="Definições Geral Ligação ao GitHub botão Criar no GitHub" width="1500" height="1000" />
  </Step>
  <Step title="O teu repositório está ligado">
    A secção mostra agora o nome do teu repositório com um link para o abrir no GitHub. A partir daqui podes enviar e recuperar alterações.
  </Step>
</Steps>

## Envia e recupera alterações

Depois de o repositório estar ligado, a secção **Ligação ao GitHub** mostra dois botões:

- **Fazer push** envia a tua versão mais recente do Vibewax para o GitHub. O Vibewax abre um pull request intitulado "Updates from Vibewax" que revês e integras no GitHub.
- **Fazer pull** substitui os ficheiros do teu projeto pela versão que está no GitHub. O Vibewax pede-te confirmação primeiro. Os teus ficheiros `.env` e `.env.local` são sempre mantidos.

Para desligar o repositório, clica no botão `X` junto ao nome dele.

## Importa um projeto do GitHub

Podes iniciar um novo projeto Vibewax a partir de um repositório que tenhas enviado anteriormente do Vibewax.

<Steps>
  <Step title="Ativa a ação de importação">
    Abre **Preferências** nas definições da tua conta, desce até **Avançado** e ativa **Importar do GitHub**. Isto mostra a ação no ecrã inicial.

    <img src="https://vibewax.be/docs/images/integrations_github_import.png" alt="Preferências Avançado interruptor Importar do GitHub" width="1500" height="1000" />
  </Step>
  <Step title="Abre Importar do GitHub">
    No ecrã inicial, abre o menu **+** na barra de prompt e escolhe **Importar do GitHub**.
  </Step>
  <Step title="Escolhe um repositório">
    Pesquisa o repositório e seleciona-o. O Vibewax cria um novo projeto a partir dele. Usa **Configurar** para voltar a ligar o GitHub ou mudar de conta, e **Atualizar** para recarregar a lista. Só vês os repositórios a que a tua conta GitHub tem acesso.
  </Step>
</Steps>

<Note>
  A importação funciona com repositórios que o Vibewax criou. Importar um repositório externo, não criado pelo Vibewax, não é suportado.
</Note>

## O que é sincronizado

Os ficheiros do teu projeto, componentes, páginas, estilos, recursos e configuração do Vibewax estão incluídos. As variáveis de ambiente (ficheiros `.env`) e os ficheiros de cache nunca são enviados, e o pull nunca substitui os teus `.env` e `.env.local`.

## Boa a saber

- **Os repositórios são sempre privados.** O teu código nunca é tornado público pelo Vibewax.
- **Uma conta GitHub gratuita é suficiente.** Não precisas de um plano GitHub pago.
- **O push abre um pull request** que integras no GitHub. Não altera o teu site em produção.
- **O pull substitui os ficheiros do teu projeto** mas mantém os teus `.env` e `.env.local`.


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