Documentación

Fundamentos

Comandos de Git y GitHub

Configura Git en tu terminal la primera vez, y ten a mano los comandos que de verdad vas a usar.

gitGitHubCursor

En Git en 5 minutos haces todo con clics dentro de Cursor. Esta página es la versión desde la terminal: primero dejas Git configurado (una sola vez) y luego tienes la lista de comandos que vas a repetir todo el curso.

Haz todo esto en la terminal de Cursor

Ábrela con Terminal → New Terminal o el atajo Ctrl+` (en Mac también Cmd+`). ¿Nunca la abriste? → La terminal sin miedo.

Parte 1 · Configura Git

Tu nombre y correo de Git ya los configuraste al preparar tu compu — el paso a paso vive en Prepara tu compu → Configura tu identidad de Git. Verifica que sigue en su lugar (debe mostrar tu nombre y correo, el mismo de GitHub):

Terminal
git config --global --list

Un ajuste extra que sí es de esta página — deja main como nombre de rama por defecto (es el estándar hoy):

Terminal
git config --global init.defaultBranch main
Checkpoint

git config --global --list muestra tu nombre y tu correo. ✅ El correo es el mismo de tu cuenta de GitHub.

Parte 2 · Los comandos

No hay que memorizarlos: vuelve aquí cuando dudes. Todos se corren parado dentro de la carpeta de tu proyecto (usa cd VibeFast para entrar).

Empezar un proyecto

ComandoQué hace
git clone <url>Baja un repo de GitHub a tu compu (crea la carpeta). Usa la URL HTTPS (botón verde Code → HTTPS).
cd VibeFastEntra a la carpeta del proyecto para poder correr los demás comandos.
cursor .Abre la carpeta actual en Cursor.

Ver qué está pasando

ComandoQué hace
git statusMuestra qué archivos cambiaste y cuáles están listos para guardar. El que más vas a usar.
git log --onelineLista tus commits (puntos de guardado), uno por línea. Sal con q.
git diffMuestra línea por línea lo que cambiaste desde el último commit.
git remote -vMuestra a qué repo de GitHub está conectado tu proyecto.

Guardar tu trabajo (commit)

ComandoQué hace
git add .Prepara todos tus cambios para el próximo commit.
git add <archivo>Prepara solo ese archivo.
git commit -m "mensaje"Crea el punto de guardado con un mensaje claro (ej. landing: nueva sección de precios).

Publicar y traer cambios

ComandoQué hace
git pushSube tus commits a GitHub. Esto también publica tu sitio si usas Vercel.
git pullTrae a tu compu los cambios que estén en GitHub. Hazlo antes de empezar a trabajar.

Ramas

ComandoQué hace
git branchLista tus ramas y marca en cuál estás.
git switch -c nombreCrea una rama nueva y te cambia a ella (ej. git switch -c prueba-precios).
git switch mainRegresa a la rama principal.

Comandos que borran trabajo — úsalos con cuidado

git restore <archivo> descarta los cambios no guardados de ese archivo (no hay deshacer). git reset --hard borra cambios de golpe. Si dudas, no los corras: pega tu situación en Cursor y pregunta antes.

El flujo del día a día (el 90% del tiempo)

git pull (traer lo último) → trabajas en Cursor → git add .git commit -m "..."git push. Eso es todo.

Checkpoint

✅ Sabes que git status te dice en qué punto estás. ✅ Puedes guardar con git add . + git commit -m "..." y publicar con git push. ✅ Sabes que pull → add → commit → push es la rutina.

Parte 3 · Sync de tu fork

Tú trabajas sobre tu fork (tu copia). El repo original de VibeFast sigue mejorando, y de vez en cuando querrás traer esas mejoras a tu copia. Hay dos formas.

La fácil: botón de GitHub

  1. Entra a tu fork en GitHub (github.com/TU-USUARIO/VibeFast).
  2. Arriba, junto a la rama, verás Sync fork → haz clic.
  3. Botón Update branch. Listo: tu fork en GitHub queda al día.
  4. En tu compu, baja esos cambios: git pull.

Si sale 'This branch has conflicts that must be resolved'

Significa que tocaste los mismos archivos que cambiaron en el original. No te asustes: pega ese mensaje en Cursor y pídele que te guíe a resolver el conflicto paso a paso.

La de terminal: remoto upstream

La primera vez, agrega el repo original como un segundo remoto llamado upstream (solo se hace una vez):

Terminal
git remote add upstream https://github.com/arampersand/VibeFast.git

De ahí en adelante, cada vez que quieras traer las mejoras del original:

Terminal
git fetch upstream
git switch main
git merge upstream/main
git push

Eso baja lo nuevo del original (fetch), lo une a tu rama main (merge) y sube el resultado a tu fork (push). Verifica que quedó con git remote -v: debes ver origin (tu fork) y upstream (el original).

origin vs. upstream

origin es tu fork (a donde subes con push). upstream es el repo original (de donde jalas mejoras, pero nunca subes). Así tu trabajo va a tu copia y solo traes lo bueno del original.

Checkpoint

✅ Agregaste upstream apuntando al repo original (o usas el botón Sync fork). ✅ Puedes traer mejoras con fetchmerge upstream/mainpush. ✅ Tienes claro que origin = tu fork y upstream = el original.

¿Un comando tronó? → Leer errores sin pánico.