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

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

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

<Callout icon="user">
  Disponível nos [**planos Pro e Agência**](/docs/pt-BR/welcome/pricing). Você pode se conectar por qualquer workspace pago do qual seja membro, mesmo que seu workspace pessoal esteja no plano Gratuito.
</Callout>

## 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 Macaly 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 Macaly 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 Macaly 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 Macaly cria um repositório privado e sincroniza seu projeto nele.

    <img src="https://mintcdn.com/macaly-41b1d3e9/mNLiN7clTmvYwZ90/images/integrations_github_create.png?fit=max&auto=format&n=mNLiN7clTmvYwZ90&q=85&s=52b1131022af029916fa54a18c0d8733" alt="Botão Criar no GitHub na seção Conexão ao GitHub da aba Geral das configurações" width="2400" height="1600" data-path="images/integrations_github_create.png" />
  </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 Macaly para o GitHub. O Macaly abre um pull request com o título "Updates from Macaly", que você revisa e mescla no GitHub.
* **Fazer pull** substitui os arquivos do seu projeto pela versão do GitHub. O Macaly 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 Macaly a partir de um repositório que você enviou antes pelo Macaly.

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

## O que é sincronizado

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