Integración con GitHub: Guía Completa

Git y GitHub desde tu Móvil

Gestionar repositorios desde el móvil solía ser complicado. Con PocketCode, es tan fácil como en tu desktop.

Configuración Inicial

1. Conectar tu Cuenta de GitHub

1. Abre Configuración en PocketCode
2. Ve a Integraciones → GitHub
3. Toca Conectar con GitHub
4. Autoriza la aplicación

¡Listo! Ahora puedes acceder a todos tus repositorios.

2. Clonar un Repositorio

Hay tres formas de clonar:

Opción A: Desde la app

1. Toca el botón "+" en la pantalla principal
2. Selecciona "Clonar Repositorio"
3. Busca o pega la URL
4. Selecciona ubicación local

Opción B: Desde navegador

1. Abre el repo en GitHub Mobile
2. Toca "Share"
3. Selecciona "Abrir con PocketCode"

Opción C: Con comandos Git

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

Workflow Básico

Hacer Cambios

1. Edita archivos normalmente
2. Los cambios se marcan automáticamente
3. Ve el diff con un tap en el archivo

Commit y Push

# Ver estado
git status

# Añadir cambios
git add .

# Commit
git commit -m "Fix: corregir bug en login"

# Push
git push origin main

O usa la interfaz visual:

• Toca el ícono de Git
• Revisa cambios
• Escribe mensaje de commit
• Toca "Commit & Push"

Características Avanzadas

1. Gestión de Branches

# Ver branches
git branch

# Crear branch
git checkout -b feature/nueva-funcionalidad

# Cambiar de branch
git checkout main

# Merge
git merge feature/nueva-funcionalidad

2. Pull Requests

1. Haz tus cambios en un branch
2. Push del branch
3. Toca "Crear Pull Request"
4. Completa título y descripción (y márcalo como borrador si quieres)
5. Crea el PR

3. Resolver Conflictos

Cuando hay conflictos:

1. PocketCode los detecta automáticamente
2. Muestra los archivos con conflictos
3. Abre el archivo
4. Ve las diferencias lado a lado
5. Elige qué cambios mantener
6. Guarda y commit

# Después de resolver manualmente
git add archivo-conflicto.js
git commit -m "Resolver conflicto en archivo-conflicto.js"

4. Stash Changes

Guarda cambios temporalmente:

# Guardar cambios
git stash

# Ver stashes
git stash list

# Recuperar cambios
git stash pop

Workflows Comunes

Workflow 1: Quick Fix

# 1. Asegúrate de estar en main
git checkout main

# 2. Pull últimos cambios
git pull

# 3. Haz el fix
# ... edita archivos ...

# 4. Commit y push
git add .
git commit -m "Fix: bug urgente en producción"
git push

Workflow 2: Nueva Feature

# 1. Crear branch desde main
git checkout main
git pull
git checkout -b feature/nueva-api

# 2. Desarrollar
# ... implementa la feature ...

# 3. Commit frecuente
git add .
git commit -m "feat: agregar endpoint /api/users"

# 4. Push y crear PR
git push -u origin feature/nueva-api
# Luego crear PR desde la app

Workflow 3: Hotfix

# 1. Branch desde producción
git checkout production
git checkout -b hotfix/critical-bug

# 2. Fix rápido
# ... corregir ...

# 3. Commit y merge directo
git add .
git commit -m "hotfix: corregir error crítico"
git checkout production
git merge hotfix/critical-bug
git push

Buenas Prácticas

Commits

✅ Buenos mensajes:

feat: agregar login con Google
fix: corregir validación de email
docs: actualizar README con instrucciones
refactor: simplificar función de búsqueda

❌ Malos mensajes:

cambios
fix
wip
asdfgh

Branches

Usa nombres descriptivos:

• feature/nombre-feature
• fix/descripcion-bug
• hotfix/critical-issue
• refactor/nombre-refactor

Antes de Push

1. ✅ Revisa tus cambios
2. ✅ Corre tests (si existen)
3. ✅ Pull antes de push (evita conflictos)
4. ✅ Escribe mensaje descriptivo

Configuración Avanzada

Personal Access Token

PocketCode se autentica en GitHub por HTTPS con un Personal Access Token (PAT):

1. Crea un token en GitHub Settings → Developer settings → Personal access tokens
2. Concédele acceso al repositorio
3. Pega el token en PocketCode cuando se te solicite (en GitHub, el token va en el campo de nombre de usuario)
4. Usa URLs HTTPS: https://github.com/user/repo.git

.gitignore

Crea un .gitignore para ignorar archivos:

# Dependencies
node_modules/
venv/
__pycache__/

# Build outputs
dist/
build/
*.pyc

# Environment
.env
.env.local

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

Git Hooks

Automatiza tareas:

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

Colaboración

Code Review desde Móvil

1. Abre el PR
2. Ve sus reviews existentes y el estado de aprobación
3. Añade un comentario a la conversación del PR

Enviar una review formal de aprobar/solicitar cambios, y los comentarios anclados a líneas concretas, todavía no están integrados en la app — hazlos desde la interfaz web de GitHub. Lo que PocketCode muestra hoy es el estado de review y la conversación del PR.

Discusiones

• Responde a comentarios
• Menciona colaboradores con @username
• Usa emojis para reacciones rápidas

Solución de Problemas

"No puedo hacer push"

# Primero pull
git pull origin main

# Resolver conflictos si hay
# Luego push
git push

"Cloné el repo pero no veo los archivos"

Verifica:

1. ¿Estás en el directorio correcto?
2. ¿El repositorio está vacío?
3. ¿Hay errores en el log?

"Los cambios no aparecen en GitHub"

# Verifica que hiciste push
git status

# Si dice "Your branch is ahead"
git push

Conclusión

Con PocketCode tienes el poder completo de Git y GitHub en tu móvil. Ya no hay excusas para no hacer ese commit urgente.

Próximo tutorial: Deploy automático desde GitHub con Vercel

¿Preguntas? Únete a nuestro Discord

¡Happy coding! 🚀