Integração com GitHub: Guia Completo

Git e GitHub do Seu Celular

Gerenciar repositórios pelo celular costumava ser complicado. Com o PocketCode, é tão fácil quanto no computador.

Configuração Inicial

1. Conecte Sua Conta do GitHub

1. Abra Configurações no PocketCode
2. Vá em Integrações → GitHub
3. Toque em Conectar com o GitHub
4. Autorize o aplicativo

Pronto! Agora você pode acessar todos os seus repositórios.

2. Clone um Repositório

Há três formas de clonar:

Opção A: Pelo aplicativo

1. Toque no botão "+" na tela inicial
2. Selecione "Clonar Repositório"
3. Pesquise ou cole a URL
4. Selecione o local de destino

Opção B: Pelo navegador

1. Abra o repositório no GitHub Mobile
2. Toque em "Compartilhar"
3. Selecione "Abrir com o PocketCode"

Opção C: Com comandos Git no terminal

git clone https://github.com/username/repo.git

Fluxo de Trabalho Básico

Faça Alterações

1. Edite os arquivos normalmente
2. As alterações são marcadas automaticamente
3. Veja o diff tocando no arquivo

Commit e Push

# Ver o status
git status

# Adicionar alterações
git add .

# Fazer o commit
git commit -m "Fix: corrige bug de login"

# Enviar (push)
git push origin main

Ou use a interface visual:

• Toque no ícone do Git
• Revise as alterações
• Escreva a mensagem de commit
• Toque em "Commit & Push"

Recursos Avançados

1. Gerenciamento de Branches

# Ver branches
git branch

# Criar branch
git checkout -b feature/nova-funcionalidade

# Trocar de branch
git checkout main

# Mesclar (merge)
git merge feature/nova-funcionalidade

2. Pull Requests

1. Faça suas alterações em uma branch
2. Envie a branch (push)
3. Toque em "Criar Pull Request"
4. Preencha o título e a descrição (e marque como rascunho, se quiser)
5. Crie o PR

3. Resolver Conflitos

Quando houver conflitos:

1. O PocketCode os detecta automaticamente
2. Mostra os arquivos com conflitos
3. Abra o arquivo
4. Veja as diferenças lado a lado
5. Escolha quais alterações manter
6. Salve e faça o commit

# Depois de resolver manualmente
git add arquivo-conflito.js
git commit -m "Resolve conflito em arquivo-conflito.js"

4. Guardar Alterações (Stash)

Salve alterações temporariamente:

# Guardar alterações
git stash

# Ver os stashes
git stash list

# Recuperar alterações
git stash pop

Fluxos de Trabalho Comuns

Fluxo 1: Correção Rápida

# 1. Certifique-se de estar na main
git checkout main

# 2. Baixe as últimas alterações
git pull

# 3. Faça a correção
# ... edite os arquivos ...

# 4. Commit e push
git add .
git commit -m "Fix: bug urgente em produção"
git push

Fluxo 2: Nova Funcionalidade

# 1. Crie a branch a partir da main
git checkout main
git pull
git checkout -b feature/nova-api

# 2. Desenvolva
# ... implemente a funcionalidade ...

# 3. Commits frequentes
git add .
git commit -m "feat: adiciona endpoint /api/users"

# 4. Push e crie o PR
git push -u origin feature/nova-api
# Depois crie o PR pelo aplicativo

Fluxo 3: Hotfix

# 1. Crie a branch a partir de produção
git checkout production
git checkout -b hotfix/bug-critico

# 2. Correção rápida
# ... corrija ...

# 3. Commit e merge direto
git add .
git commit -m "hotfix: corrige erro crítico"
git checkout production
git merge hotfix/bug-critico
git push

Boas Práticas

Commits

✅ Boas mensagens:

feat: adiciona login com Google
fix: corrige validação de e-mail
docs: atualiza README com instruções
refactor: simplifica função de busca

❌ Mensagens ruins:

alterações
fix
wip
asdfgh

Branches

Use nomes descritivos:

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

Antes do Push

1. ✅ Revise suas alterações
2. ✅ Rode os testes (se existirem)
3. ✅ Faça pull antes do push (evita conflitos)
4. ✅ Escreva uma mensagem descritiva

Configuração Avançada

Personal Access Token

O PocketCode se autentica no GitHub por HTTPS com um Personal Access Token (PAT):

1. Crie um token em GitHub Settings → Developer settings → Personal access tokens
2. Conceda a ele acesso ao repositório
3. Cole o token no PocketCode quando solicitado (no GitHub, o token vai no campo de nome de usuário)
4. Use URLs HTTPS: https://github.com/user/repo.git

.gitignore

Crie um .gitignore para ignorar arquivos:

# Dependências
node_modules/
venv/
__pycache__/

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

# Ambiente
.env
.env.local

# IDE
.vscode/
.idea/

# Sistema operacional
.DS_Store
Thumbs.db

Git Hooks

Automatize tarefas:

# .git/hooks/pre-commit
#!/bin/sh
npm run lint
npm test

Colaboração

Code Review pelo Celular

1. Abra o PR
2. Veja as revisões existentes e o status de aprovação
3. Adicione um comentário à conversa do PR

Enviar uma revisão formal de aprovar/solicitar mudanças, e comentários ancorados em linhas, ainda não estão integrados ao app — faça isso pela interface web do GitHub. O que o PocketCode mostra hoje é o estado da revisão do PR e a conversa.

Discussões

• Responda aos comentários
• Mencione colaboradores com @username
• Use emojis para reações rápidas

Solução de Problemas

"Não consigo fazer push"

# Primeiro faça pull
git pull origin main

# Resolva os conflitos, se houver
# Depois faça o push
git push

"Clonei o repositório, mas não vejo os arquivos"

Verifique:

1. Você está no diretório correto?
2. O repositório está vazio?
3. Há erros no log?

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

# Confirme que você fez o push
git status

# Se disser "Your branch is ahead"
git push

Conclusão

Com o PocketCode você tem todo o poder do Git e do 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! 🚀