Integração com GitHub: Guia Completo

Aprenda a conectar seus repositórios do GitHub e gerenciar código diretamente do PocketCode no seu celular.

Git e GitHub do Seu Celular

Gerenciar repositórios pelo celular costumava ser complicado. O PocketCode traz o Git integrado (a biblioteca JGit, sem nada para instalar), então o ciclo do dia a dia funciona no seu telefone: clonar, preparar, fazer commit, enviar e pull requests. Este guia segue as telas reais; a documentação de Git e GitHub explica cada uma em detalhe.

Configuração Inicial

1. Conecte Sua Conta do GitHub

Abra Configurações → Integrações → Serviços conectados e escolha GitHub
Toque em Entrar com um código e depois em Pedir um código ao GitHub
Toque em Abrir GitHub, digite o código que o PocketCode mostra na página que abrir (github.com/login/device) e aprove (fluxo de dispositivo OAuth)
Deixe a folha aberta: ela conecta sozinha assim que você aprova

Não há token para copiar. O código dura cerca de 15 minutos; se expirar, peça outro. No plano Free a primeira conta de cada provedor está incluída; conectar mais é Pro.

2. Clone um Repositório

Vá em Projetos e toque em Clonar
Escolha Clonar do GitHub (ou GitLab / Bitbucket). Se ainda não conectou, toque em Conectar primeiro
Escolha um dos seus repositórios (dá para buscar) e toque em Clonar

O repositório aparece como um projeto novo. Se o nome já existir, o clone recebe um sufixo como repo (2). Você clona a partir da lista dos seus próprios repositórios e só por HTTPS: remotos SSH e clonar colando uma URL não são suportados. O terminal local não tem um programa git, então lá não existe git clone; use o botão Clonar.

Fluxo de Trabalho Básico

Faça Alterações

Edite arquivos normalmente
Em um repositório, o explorador de arquivos marca os arquivos que mudaram e a barra de status mostra o branch com os contadores ↑↓
Abra o Controle de código-fonte (menu do editor → Git, ou Ctrl+Shift+G com teclado físico, ou toque no nome do branch na barra de status) e toque em um arquivo para ver o diff: as linhas adicionadas e removidas em uma única lista

Commit e Push

No editor:

Abra o Controle de código-fonte
Revise as alterações e Prepare os arquivos que quiser (Preparar tudo para todos, ou Preparar por fragmentos para só parte de um arquivo)
Escreva uma mensagem de commit e toque em Confirmar
Toque no ícone Enviar do cabeçalho

O editor não mostra mensagem de sucesso nem de erro depois de um commit, push ou pull: julgue o resultado pelas listas e pelos contadores ↑↓. Se um push parecer não fazer nada, repita pelo Projetos, que mostra o erro.

Pelo cartão do projeto em Projetos você também pode tocar em Commit, marcar os arquivos, escrever a mensagem e tocar em Commit & Push (quando o projeto tem remoto). Defina antes Seu nome nos commits em Git.

O botão Mensagem com IA sugere mensagens de commit em quatro estilos, mas não é IA: é uma sugestão local, baseada em regras, montada a partir dos nomes dos arquivos que você alterou, sem modelo e sem chave.

Recursos Avançados

1. Gerenciamento de Branches

Criar e trocar: no cartão do projeto toque em Git e depois em Ramo. Toque em um branch para trocar para ele, ou em Criar nova branch. Essas linhas aparecem quando o projeto tem remoto (origin); o Painel Git do terminal também troca e cria branches localmente
Mesclar: no Controle de código-fonte toque em Mesclar, escolha um dos seus branches locais e toque em Mesclar em main (ou no branch em que você estiver)
Comparar: Comparar mostra a distância entre dois branches locais: commits à frente e atrás, e os arquivos alterados

Essas listas só mostram branches locais.

2. Pull Requests

Abra PRs e issues do GitHub pelo menu Git do editor. Funciona com projetos cujo origin está no github.com e usa a conta que você conectou.

Faça suas alterações em um branch
Envie o branch (Enviar alterações na folha Git do projeto)
Na aba PRs toque em Novo pull request de …
Preencha título e descrição, escolha o branch base e o de origem (e marque como rascunho se quiser)
Toque em Criar pull request

A mesma folha tem as abas Issues, CI e Avisos. De um pull request você pode fazer merge (merge commit, squash ou rebase), fechar e escrever um comentário.

3. Resolva Conflitos

O PocketCode tem um único resolvedor guiado de conflitos, e ele fica dentro do rebase interativo: para cada bloco em conflito você escolhe Ours, Theirs ou Both. Para um merge ou um pull que dá conflito não existe resolvedor: os marcadores (<<<<<<<, =======, >>>>>>>) ficam nos seus arquivos e o editor não lista os arquivos em conflito. Abra os arquivos afetados, fique com a versão que quiser, remova os marcadores, e depois prepare e faça o commit.

4. Guarde Alterações à Parte (Stash)

Guarde alterações temporariamente pelo Controle de código-fonte: toque em Guardar à parte e depois em Guardar as alterações à parte. Toque em uma entrada para Aplicar, Recuperar ou Descartar. Lembre que arquivos novos (não rastreados) não entram no stash, a mensagem do stash não é guardada e Recuperar sempre pega a entrada mais recente.

5. Rebase e Cherry-pick

O rebase interativo (Pick, Reword, Squash, Fixup, Drop, com um backup restaurável) e o Cherry-pick (por hash de commit) abrem pelo menu ⋮ da folha do GitHub, e só quando o origin do projeto está no github.com. Em Projetos → Git → Histórico, tocar em um commit oferece Revert, Reset Soft, Reset Hard e Cherry-pick. O Reset Hard roda sem perguntar e descarta o trabalho não commitado.

Fluxos de Trabalho Comuns

Fluxo 1: Correção Rápida

No cartão do projeto abra Git → Ramo e troque para main
Toque em Obter alterações para trazer as últimas
Faça a correção no editor
Toque em Commit, escreva a mensagem e toque em Commit & Push

Fluxo 2: Nova Funcionalidade

Troque para main, toque em Obter alterações e depois em Criar nova branch (ex.: feature/new-api) com a opção de trocar ligada
Desenvolva, fazendo commits com frequência pelo Controle de código-fonte
Toque em Enviar alterações e depois em Novo pull request de … na folha do GitHub

Fluxo 3: Hotfix

Troque para o branch de produção e crie hotfix/critical-bug
Faça a correção e o commit
Volte ao branch de produção, abra Controle de código-fonte → Mesclar, escolha o branch do hotfix e toque em Mesclar em …
Toque em Enviar alterações

Boas Práticas

Commits

✅ Boas mensagens:

feat: add Google login
fix: correct email validation
docs: update README with instructions
refactor: simplify search function

❌ Más mensagens:

changes
fix
wip
asdfgh

Branches

Use nomes descritivos:

feature/nome-da-funcionalidade
fix/descricao-do-bug
hotfix/problema-critico
refactor/nome-do-refactor

Antes do Push

✅ Revise suas alterações
✅ Execute os testes (se existirem)
✅ Obtenha antes as alterações remotas (evita conflitos)
✅ Escreva uma mensagem descritiva

Configuração Avançada

Seu token e para onde ele vai

O token que você recebe com Entrar com um código fica salvo criptografado no seu telefone (AES-256-GCM com uma chave do Android Keystore), separado para cada conta do PocketCode e cada conta de provedor
O Git o envia somente para github.com, gitlab.com e bitbucket.org (correspondência exata do host). A folha do GitHub o envia para api.github.com direto do seu telefone. Um remoto em qualquer outro host (GitHub Enterprise, um GitLab próprio, Gitea…) não recebe credenciais, então repositórios privados lá falham
Se você entra no próprio PocketCode com o GitHub, esse token do GitHub também é guardado, criptografado (AES-256-GCM), no backend do PocketCode: o backend o usa para listar seus repositórios e o app pode recuperá-lo de lá

.gitignore

Começar a rastrear este projeto (cartão do projeto → Git) cria um repositório local com um .gitignore que deixa de fora a pasta .pocketcode/ do próprio PocketCode. Adicione suas regras editando esse arquivo:

# Dependências
node_modules/
venv/
__pycache__/

# Saídas de build
dist/
build/
*.pyc

# Ambiente
.env
.env.local

# IDE
.vscode/
.idea/

# SO
.DS_Store
Thumbs.db

O que não é suportado

Remotos SSH (git@…, ssh://): use o endereço HTTPS
Git LFS (os arquivos ficam como pequenos ponteiros de texto), submódulos e assinatura de commits
Hooks do Git: nunca são executados
Pull requests, issues, CI e avisos de GitLab, Bitbucket ou GitHub Enterprise: exigem um repositório do github.com
As listas da folha do GitHub param em 300 itens

Colaboração

Code Review pelo Celular

Abra o PR
Veja as revisões, os checks e o status de aprovação
Adicione um comentário à conversa do PR

Enviar uma revisão formal de aprovar/pedir alterações, e comentários ancorados em uma linha, ainda não estão ligados no app — faça isso pela web do GitHub. O que o PocketCode mostra hoje é o estado de revisão do PR e a conversa.

Discussões

Escreva comentários na conversa do PR ou da issue
Mencione colaboradores com @usuario

Solução de Problemas

"Não consigo fazer push"

Se o app disser "O remoto rejeitou o envio. Obtenha primeiro as alterações do remoto e envie de novo.":

Toque em Obter alterações
Resolva os conflitos, se houver (veja acima)
Toque em Enviar alterações de novo

"Cloneei o repositório mas não vejo arquivos"

Verifique:

O clone é um projeto novo na página Projetos: abra-o por lá
O repositório está vazio?
Arquivos gerenciados pelo Git LFS chegam como pequenos ponteiros de texto, não o conteúdo real

"As alterações não aparecem no GitHub"

Um commit sozinho não envia nada, e Publicar só cria e vincula o repositório vazio. Se a barra de status mostra commits à frente (↑) ou o cartão do projeto diz Push, toque em Enviar alterações (ou no ícone Enviar do Controle de código-fonte).

Conclusão

Com o PocketCode você tem o fluxo do dia a dia de Git e GitHub no seu celular. Sem mais desculpas para não fazer aquele commit urgente. Para dar os primeiros passos, confira o guia de introdução e explore os projetos no PocketCode.

Próximo tutorial: Deploy automático a partir do GitHub com Vercel

Dúvidas? Escreva para [email protected]

Bom código! 🚀