VOLVER A LA RUTA
MÓDULO 03 · 30 MIN
PRINCIPIANTE

TU PRIMER REPOSITORIO

Crea tu primer repo en GitHub y sube código paso a paso, como una receta.

01

PASO 1 · CREAR EL REPO EN GITHUB

Vamos a crear el repositorio en la web de GitHub primero, así tenemos a dónde subir nuestro código.

1. Abre github.com e inicia sesión. 2. Haz click en el botón verde 'New' (arriba a la izquierda) o ve a github.com/new. 3. Llena el formulario: • Repository name: mi-primer-repo • Description: (opcional) • Public o Private (lo que prefieras) • NO marques 'Add a README file' (lo crearemos nosotros). • NO añadas .gitignore ni licencia por ahora. 4. Click en 'Create repository'.

GitHub te mostrará una página con instrucciones. Quédate ahí, en el siguiente paso copiaremos la URL.

PRO TIP

Si trabajas en equipo, crea el repo dentro de la organización de tu organizacion, no en tu cuenta personal.

02

PASO 2 · CREAR LA CARPETA DEL PROYECTO EN TU COMPUTADORA

Abre tu terminal (en Windows usa Git Bash) y crea una carpeta vacía donde va a vivir tu proyecto.

03

PASO 3 · INICIALIZAR GIT EN LA CARPETA

Esto le dice a Git: 'esta carpeta ahora es un repositorio'. Crea una carpeta oculta .git que guarda todo el historial.

PRO TIP

Si ves un mensaje sobre la rama 'master', es la rama por defecto antigua. Hoy se usa 'main'. Por eso corrimos 'git branch -M main'.

04

PASO 4 · TU PRIMER COMMIT

Git tiene 3 áreas mentales:

• WORKING DIRECTORY: tus archivos tal como están en la carpeta. • STAGING AREA: lo que vas a empaquetar en el próximo commit. • REPOSITORIO: el historial guardado.

Flujo: editas → 'git add' (manda al staging) → 'git commit' (empaqueta y guarda).

PRO TIP

Mensajes de commit en presente y descriptivos. Mal: 'cambios'. Bien: 'Agrega validación de email en login'.

05

PASO 5 · CONECTAR TU CARPETA CON EL REPO DE GITHUB

Ahora le decimos a Git dónde está el repositorio remoto en GitHub.

Ve a la página de tu repo en GitHub (la del Paso 1). Copia la URL HTTPS o SSH (recomendado SSH si configuraste SSH key en módulo 2).

Tendrá esta forma: • HTTPS: https://github.com/tu-usuario/mi-primer-repo.git • SSH: [email protected]:tu-usuario/mi-primer-repo.git

06

PASO 6 · SUBIR TU CÓDIGO A GITHUB (PUSH)

Llegó el momento mágico: subir tu código.

El primer push usa la opción '-u' para que Git recuerde dónde subir y bajar en el futuro. Después solo necesitas 'git push'.

PRO TIP

Recarga tu repo en GitHub: ¡tus archivos están ahí! Acabas de hacer tu primer push.

07

PASO 7 · HACER CAMBIOS Y VOLVER A SUBIR

El ciclo de trabajo del día a día se repite:

1. Editas archivos. 2. 'git status' para ver qué cambió. 3. 'git add .' para preparar los cambios. 4. 'git commit -m "..."' para guardarlos. 5. 'git push' para subirlos.

Practicalo: edita tu README, agrega una línea, y sube el cambio.

PRO TIP

Por ahora estás trabajando directo en main porque es tu repo personal de prueba. En el siguiente módulo aprenderás a usar ramas, que es como SE DEBE trabajar en equipo.