# Sincronização com o GitHub

Conecte o GitHub com um código de dispositivo ou um token, publique um projeto como repositório novo ou existente, envie e receba entre máquinas, e saiba como o seu token é protegido.

A sincronização com o GitHub é um backup opcional fora da máquina e uma transferência de trabalho entre computadores, construída sobre o [repositório Git real](/docs/git-history/) que cada projeto já é. Os commits locais funcionam sem GitHub. Quando você conecta, ainda não há uma conta do Oleafly no caminho: apenas o seu GitHub.

## Conectando a sua conta

Configurações, **Integrações**, **GitHub**, e então um dos caminhos:

- **Conectar o GitHub** (recomendado): um fluxo de código de dispositivo. O Oleafly mostra um código curto, o seu navegador abre `github.com/login/device` (com um botão **Copiar** para o código), você aprova, e o aplicativo detecta em segundos. A conexão pede apenas os escopos `repo` e `read:user`.
- **Token de acesso pessoal**: expanda "Avançado: usar um token de acesso pessoal" e cole um PAT se você preferir criar as suas próprias credenciais.

Depois de conectado, o seu avatar e o seu nome de usuário aparecem nas Configurações e no menu do GitHub da barra de ferramentas superior. **Desconectar** esquece o token.

### Como o seu token é protegido

O token é guardado em um arquivo local criptografado com AES-256-GCM e restrito ao seu dono, e nunca é entregue à camada de interface do aplicativo; a interface só fica sabendo que você está "conectado como @você". Quando o Git precisa se autenticar, o token é injetado por um auxiliar de credenciais em memória, então ele nunca aparece em uma linha de comando, no `.git/config` ou no histórico do seu shell. Versões mais antigas que embutiam tokens nas URLs dos remotos são limpas automaticamente na inicialização.

## Publicando um projeto

No painel de Controle de versão, clique em **Publicar no GitHub**:

- **Criar novo repositório**: escolha um nome (pré-preenchido a partir do projeto), deixe **Privado** (recomendado) marcado ou não, e **Criar e enviar**. O Oleafly cria o repositório, faz o commit dos arquivos do projeto, conecta o `origin` e envia.
- **Vincular a um existente**: escolha em uma lista com busca dos seus repositórios (os privados mostram um cadeado) e **Vincular e enviar**.

Depois de publicar, o menu do GitHub na barra de ferramentas oferece **Abrir no GitHub** e **Copiar o link do repositório**.

### Arquivos que parecem segredos ficam locais

A publicação nunca faz commit de arquivos que normalmente guardam chaves ou senhas, como `.env`, `*.pem`, chaves privadas SSH ou `credentials.json`. Eles ficam na pasta do projeto, sem preparo, e a caixa de diálogo os nomeia. Para publicar um deles mesmo assim, prepare-o e faça o commit você mesmo no Controle de versão. Modelos como `.env.example`, chaves públicas e arquivos `.key` do Keynote são publicados como de costume.

Um envio sobe o histórico inteiro. Se um arquivo com um desses nomes já foi commitado, o Oleafly o lista e espera por **Cancelar** ou **Publicar mesmo assim** antes de criar qualquer coisa no GitHub.

## Sincronização do dia a dia

Os botões **Enviar** e **Receber** do painel de Controle de versão fazem o que dizem, contra o `origin` na sua branch atual. **Buscar** e **Sincronizar** estão no menu **Mais ações do controle de versão**, e **Commit e envio** e **Commit e sincronização** estão no menu ao lado de **Fazer commit**. O indicador **à frente/atrás** (↑ ↓) ao lado da etiqueta da branch avisa quando há algo para enviar ou receber.

### Dois computadores

1. Na máquina A: publique o projeto, trabalhe, **Envie**.
2. Na máquina B: conecte a mesma conta do GitHub, escolha **Importar um projeto → GitHub** e selecione o repositório. Veja o [guia de importação](/docs/import-project/#import-from-github). A partir daí, **Receba**, trabalhe, **Envie**.
3. De volta à A: **Receba** antes de começar. O indicador lembra você.

A cor da capa, a escolha do documento principal e o histórico viajam juntos, porque vivem na própria pasta do projeto.

## Mudando de ideia

Depois que um remoto é definido, o menu **Mais ações do controle de versão** ganha dois itens a mais:

- **Trocar de repositório** reabre a caixa de diálogo de publicação para apontar o `origin` para outro lugar.
- **Desvincular** remove o remoto; o projeto local e o histórico dele ficam intocados.

## Conflitos e branches

Se um recebimento esbarra em um conflito de mesclagem, o Controle de versão lista os arquivos em conflito. Escolha **Usar a atual** ou **Usar a recebida** para cada um, ou edite o arquivo e escolha **Marcar como resolvido**, depois **Concluir a mesclagem**. **Abortar a mesclagem** devolve os arquivos ao estado anterior. Enviar e Receber funcionam na branch em que você está, e o menu de branches no topo do painel troca ou cria branches. Veja [Git e controle de versão](/docs/git-history/#branches-and-stashes).

## Limites, ditos com clareza

O Oleafly autentica remotos HTTPS. A publicação configura um corretamente para você.

## Se algo falhar

- "No remote 'origin'": publique primeiro; Enviar e Receber precisam de um remoto.
- Envio rejeitado porque o remoto tem commits: receba primeiro e depois envie.
- "No GitHub token set": conecte em Configurações, Integrações, GitHub.

Mais no [FAQ](/docs/faq/#history-and-collaboration).
