Comandos del repo

Todos los comandos del starter, qué hacen y cuándo los usas.

Son iguales en Windows, macOS y Linux, porque todos corren con npm. Donde algo cambia por sistema operativo, lo dice la línea.

Los del día a día

npm install

Instala las dependencias. Una vez, al clonar.

npm run doctor

Revisa que tu laptop pueda construir el altar: Node, Git, npm, AWS CLI y los perfiles de AWS con su Región. No lee tus llaves ni hace peticiones de red. Cuando algo falta, imprime el arreglo para tu sistema operativo.

npm run dev

Levanta el altar en http://localhost:3000, solo en tu máquina. Se recarga al guardar un archivo.

npm run build

Construye el sitio en dist/, que es exactamente lo que publica Amplify.

npm run preview

Sirve lo que construyó npm run build. Úsalo para ver el resultado real antes de subir nada.

Los de infraestructura

npm run synth

Convierte tu infra/ofrenda-stack.ts en la plantilla de CloudFormation, sin desplegar nada. Es la forma rápida de ver si tu código de CDK compila.

npm run diff -- --profile ofrenda

Compara lo que tienes escrito contra lo que ya está desplegado. Córrelo siempre antes de desplegar: es la diferencia entre saber qué va a pasar y enterarte después.

npm run deploy -- --profile ofrenda

Crea o actualiza los recursos en tu proyecto. Al final imprime la URL de tu API.

npm run limpiar -- --profile ofrenda

Borra el stack ofrenda: la tabla, el bucket, la API, las tres funciones del altar y la función auxiliar de limpieza que agrega CDK. Corre este comando únicamente durante el cierre del workshop.

Los checkpoints

Cada uno corresponde a un módulo y revisa de verdad, con peticiones reales, que lo que hiciste quedó funcionando.

npm run verify 2 https://main.xxxxx.amplifyapp.com

Módulo 2: que tu altar responda por Amplify, por https, y que sea tu altar y no una página de error.

npm run verify 3 https://tu-api.execute-api.tu-region.amazonaws.com/v1

Módulo 3: que tu backend funcione. Prueba CORS, crea dos elementos, los lista, sube y descarga una imagen real, revisa las validaciones y confirma que puede borrar el segundo elemento. También puede leer la URL desde VITE_API_URL en un archivo .env, pero en el workshop se la pasas directamente como argumento.

npm run verify 4 https://main.xxxxx.amplifyapp.com

Módulo 4: que tu página en producción ya esté hablando con tu backend, no solo que cargue.

Los que no son del repo

Estos los corre npx, o sea el binario que vino con las dependencias.

npx cdk bootstrap --profile ofrenda

Una vez por cuenta y Región. Prepara el lugar donde CDK sube los archivos del despliegue, creando el stack CDKToolkit.

Las ramas de rescate

Los módulos 3 y 4 tienen una rama con la solución. Estos comandos copian los archivos necesarios a tu rama main, para que conserves tus cambios y Amplify pueda publicarlos.

Antes de rescatarte, guarda lo que llevas. Igual en Windows, macOS y Linux:

git add .
git commit -m "Trabajo antes del rescate"

Para rescatar el módulo 3:

npm run rescate 3
git add .
git commit -m "Usar rescate del modulo 3"
git push origin main

Para rescatar el módulo 4 completo:

npm run rescate 4
git add .
git commit -m "Usar rescate del modulo 4"
git push origin main

⚠️ Si Git dice que modulo-3 o modulo-4 no existe

Tu fork se creó copiando únicamente main. Pide ayuda en la mesa para traer la rama desde el repo original; no borres tu trabajo para intentarlo otra vez.