Manual de
Git & GitHub.

# Identidade — aparece em todo commit que você fizer
git config --global user.name "Seu Nome"
git config --global user.email "voce@exemplo.com"

# Branch padrão em novos repositórios
git config --global init.defaultBranch main

# Editor usado para mensagens de commit (opcional)
git config --global core.editor "code --wait"

# Ver toda a configuração aplicada
git config --list

# Gera um par de chaves (Ed25519 — o padrão recomendado hoje)
ssh-keygen -t ed25519 -C "voce@exemplo.com"

# Adiciona a chave ao agente SSH
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Copia a chave pública para colar em GitHub → Settings → SSH Keys
cat ~/.ssh/id_ed25519.pub

# Testa a conexão
ssh -T git@github.com

# Criar um repositório novo na pasta atual
git init

# Clonar um repositório existente do GitHub
git clone https://github.com/usuario/repositorio.git

# Clonar via SSH (recomendado se a chave já está configurada)
git clone git@github.com:usuario/repositorio.git

# Clonar em uma pasta com outro nome
git clone git@github.com:usuario/repositorio.git nome-da-pasta

# O que mudou desde o último commit
git status

# Diferenças linha a linha (working dir vs staging)
git diff

# Preparar arquivos específicos
git add caminho/arquivo.ts

# Preparar tudo que mudou (cuidado — revise antes com git status)
git add .

# Registrar o commit com uma mensagem clara
git commit -m "feat: adiciona validação de e-mail no cadastro"

# Ver o histórico de commits
git log --oneline --graph --decorate

# Enviar seus commits para o remoto
git push

# Primeira vez enviando um branch novo
git push -u origin nome-do-branch

# Trazer e já aplicar as mudanças do remoto
git pull

# Só baixar as mudanças, sem aplicar ainda (mais seguro para inspecionar)
git fetch
git log origin/main --oneline

# Criar um branch novo a partir do atual
git branch nome-do-branch

# Criar E já trocar para ele (o jeito mais comum)
git checkout -b nome-do-branch
# equivalente moderno:
git switch -c nome-do-branch

# Trocar de branch
git switch main

# Listar branches (local e remoto)
git branch -a

# Mesclar um branch dentro do atual
git switch main
git merge nome-do-branch

# Apagar um branch já mesclado
git branch -d nome-do-branch

# Apagar um branch remoto
git push origin --delete nome-do-branch

feat(checkout): adiciona pagamento via Pix
fix(auth): corrige expiração de token que derrubava sessão
docs(readme): explica variáveis de ambiente necessárias
refactor(api): extrai validação de e-mail para função própria
chore(deps): atualiza vite para 8.0.16

# Ver remotos configurados
git remote -v

# Adicionar o repositório original como upstream (após dar fork)
git remote add upstream https://github.com/dono-original/repositorio.git

# Trazer as atualizações do upstream para o seu main local
git fetch upstream
git switch main
git merge upstream/main

# Trocar a URL de um remoto (ex.: HTTPS → SSH)
git remote set-url origin git@github.com:usuario/repositorio.git

## O que mudou
Breve resumo da mudança e por quê.

## Como testar
1. Passo a passo para reproduzir/validar.

## Screenshots (se for mudança visual)

## Checklist
- [ ] Testei localmente
- [ ] Sem segredos ou dados sensíveis no diff
- [ ] Atualizei documentação, se necessário

# Descartar mudanças não commitadas de um arquivo (CUIDADO: apaga de vez)
git restore caminho/arquivo.ts

# Tirar um arquivo do staging, mantendo as mudanças no arquivo
git restore --staged caminho/arquivo.ts

# Ver o que mudou antes de descartar (sempre rode antes do restore)
git diff caminho/arquivo.ts

# Desfaz o último commit, mantendo as mudanças como staged (o mais seguro)
git reset --soft HEAD~1

# Desfaz o último commit e tira do staging, mas mantém no working dir
git reset --mixed HEAD~1

# Desfaz o último commit E apaga as mudanças (PERIGOSO — só em commits locais)
git reset --hard HEAD~1

# Cria um commit NOVO que desfaz um commit antigo já publicado (o jeito seguro em equipe)
git revert <hash-do-commit>

# Histórico de tudo que o HEAD já apontou — inclusive commits "perdidos"
git reflog

# Voltar para um estado específico encontrado no reflog
git reset --hard HEAD@{2}

# Dependências e build
node_modules/
dist/
build/
.next/

# Variáveis de ambiente e segredos
.env
.env.local
.env.*.local
*.pem
*.key

# Sistema operacional e editor
.DS_Store
.vscode/
*.log

# Guarda as mudanças e limpa o working directory
git stash

# Guarda com uma descrição (facilita achar depois)
git stash push -m "ajuste de layout no checkout"

# Listar stashes guardados
git stash list

# Trazer de volta o último stash (e removê-lo da lista)
git stash pop

# Aplicar sem remover da lista
git stash apply

git switch main
git cherry-pick <hash-do-commit>

git bisect start
git bisect bad                # o commit atual está com o bug
git bisect good v1.2.0         # essa tag/commit estava bom
# o Git vai pulando commits no meio — teste e responda:
git bisect good   # ou
git bisect bad
# até apontar o commit exato. Depois:
git bisect reset

# Criar uma tag anotada (recomendado — guarda autor, data e mensagem)
git tag -a v1.0.0 -m "Primeira versão estável"

# Enviar tags para o remoto
git push origin v1.0.0
git push origin --tags

# Criar um repositório novo no GitHub a partir da pasta atual
gh repo create nome-do-repo --public --source=. --push

# Abrir um PR do branch atual para a main
gh pr create --base main --title "feat: checkout via Pix" --body "Descrição da mudança"

# Ver PRs abertos
gh pr list

# Fazer checkout local de um PR para revisar
gh pr checkout 42

# Aprovar e mesclar
gh pr review 42 --approve
gh pr merge 42 --squash

gh issue create --title "Bug: erro 500 no cadastro" --body "Passos para reproduzir..."
gh issue list --state open
gh issue close 17