Lo que vas a construir

Vas a crear tu primer repositorio de Git y aprender el flujo basico de control de versiones. Entenderas los commits como "guardados" de tu codigo que puedes recuperar en cualquier momento. Subiras tu proyecto a GitHub para que nunca pierdas tu trabajo, incluso si tu computadora falla. Esta es la base del control de versiones que usan todos los desarrolladores profesionales del mundo.

Paso 1: Instalar Git

Sistema	Comando
macOS	`brew install git` o viene preinstalado
Windows	Descarga de git-scm.com
Linux	`sudo apt install git`

Verifica:

git --version

Paso 2: Configurar tu identidad

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Paso 3: Crear un repositorio local

# Crea una carpeta para tu proyecto
mkdir mi-proyecto
cd mi-proyecto

# Inicializa Git
git init

# Crea un archivo
echo "# Mi Proyecto" > README.md

Paso 4: Crear .gitignore (¡CRÍTICO!)

⚠️ SIEMPRE crea .gitignore ANTES del primer commit

# Crea el archivo .gitignore
cat > .gitignore << 'EOF'
# Secretos - NUNCA subir
.env
.env.local
*.env
credentials.json
*.pem
*.key

# Dependencias
node_modules/
venv/

# Build
dist/
build/

# Sistema
.DS_Store
EOF

¿Por qué es tan importante?

Sin .gitignore	Con .gitignore
Subes `.env` con API keys	Protegido automáticamente
La IA puede commitear secretos	Git los ignora siempre
Tus credenciales en GitHub público	Seguras en tu máquina

Paso 5: Tu primer commit

# Añade los archivos al "staging"
git add .

# Guarda el estado (commit)
git commit -m "Primer commit con .gitignore"

¡Guardaste tu primer estado!

Paso 6: Crear repositorio en GitHub

Ve a github.com/new
Nombre: mi-proyecto
Déjalo público o privado
NO marques "Initialize with README"
Click en Create repository

Paso 7: Conectar y subir

GitHub te mostrará comandos. Copia y ejecuta:

git remote add origin https://github.com/TU-USUARIO/mi-proyecto.git
git branch -M main
git push -u origin main

¿Funcionó?

Recarga la página de GitHub. Deberías ver tu README.md

Flujo básico de Git

# 1. Haces cambios en tus archivos
# 2. Añades los cambios
git add .

# 3. Guardas el estado
git commit -m "Descripción del cambio"

# 4. Subes a GitHub
git push

Comandos útiles

Comando	Qué hace
`git status`	Ver qué cambió
`git log`	Ver historial de commits
`git diff`	Ver diferencias
`git pull`	Descargar cambios de GitHub

Si algo falló

Error	Causa	Solución
`not a git repository`	No hay .git	Ejecuta `git init`
`Authentication failed`	Credenciales incorrectas	Usa token personal de GitHub
`rejected non-fast-forward`	Hay cambios remotos	`git pull` primero

🤖 Tip: Checkpoints antes de usar IA

Si usas Cursor, Claude Code u otro asistente de IA:

# ANTES de pedirle algo a la IA
git add . && git commit -m "Checkpoint antes de cambios con IA"

# Si la IA rompe algo, vuelves fácil
git reset --hard HEAD

La IA es poderosa pero a veces malinterpreta. Git es tu red de seguridad.

Próximo paso

→ Mi Configuración Dotfiles — Personaliza tu entorno

📖 Quiero aprender más

→ Git & GitHub (Teoría completa) — Conceptos, branches, .gitignore y más

Mi Primer Repositorio

📋 Prerequisitos sugeridos