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

# GitHub

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

A integração do GitHub no Macaly 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.

<Callout icon="user">
  Disponível nos [**planos Pro e Agências**](/docs/pt/welcome/pricing). Podes ligar-te através de qualquer espaço de trabalho pago de que sejas membro, mesmo que o teu espaço de trabalho pessoal esteja no plano Gratuito.
</Callout>

## 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 Macaly 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 Macaly 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 Macaly 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 Macaly cria então um repositório privado e sincroniza o teu projeto com ele.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_create.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=52b1131022af029916fa54a18c0d8733" alt="Definições Geral Ligação ao GitHub botão Criar no GitHub" width="2400" height="1600" data-path="images/integrations_github_create.png" />
  </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 Macaly para o GitHub. O Macaly abre um pull request intitulado "Updates from Macaly" que revês e integras no GitHub.
* **Fazer pull** substitui os ficheiros do teu projeto pela versão que está no GitHub. O Macaly 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 Macaly a partir de um repositório que tenhas enviado anteriormente do Macaly.

<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://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_import.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=062a4da2b66d8f3e5694b99325da393c" alt="Preferências Avançado interruptor Importar do GitHub" width="2400" height="1600" data-path="images/integrations_github_import.png" />
  </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 Macaly 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 Macaly criou. Importar um repositório externo, não criado pelo Macaly, não é suportado.
</Note>

## O que é sincronizado

Os ficheiros do teu projeto, componentes, páginas, estilos, recursos e configuração do Macaly 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 Macaly.
* **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 documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.