Ofrenda en la Nube Un altar de Día de Muertos, construido con un agente

1. Arranque: tu proyecto, tu fork, tu copia

Este módulo junta cuatro herramientas: AWS, GitHub, la terminal y tu editor. Vamos paso por paso para que sepas en cuál estás trabajando.

Al final de esta página vas a tener el altar corriendo en tu laptop.

Primero, confirma tu Región

Tu proyecto de AWS vive en una sola Región, y la decidió la dirección de contacto con la que te registraste. No se puede cambiar, y todo lo que construyas tiene que crearse ahí.

Encuentra tu Región y escríbela

Entra a AWS Settings, y de ahí a View all projects → tu proyecto → Overview → Additional Info → Region.

Apúntala. La vas a necesitar en el módulo 2, y si despliegas en otra Región te va a rebotar.

Ahora el fork

Un fork es tu propia copia del repositorio, en tu cuenta de GitHub. La necesitas porque Amplify va a publicar desde tu repo, no desde el nuestro, y porque vas a hacer commits y no tienes permiso de escribir en el original.

Haz tu fork

Abre el repo del starter y dale al botón Fork, arriba a la derecha. En la pantalla que sigue, desmarca “Copy the main branch only” para que tu fork también tenga las ramas de rescate modulo-3 y modulo-4. Luego confirma con Create fork.

Cuando acabe, revisa que la barra de direcciones diga github.com/TU-USUARIO/workshop-altar-digital. Si dice otro usuario, estás viendo el original y no tu copia.

Clona tu copia

Clonar es bajar el repo a tu laptop.

Elige dónde va a vivir el proyecto

Abre tu terminal y ve a la carpeta donde guardas tus proyectos. Si no tienes una, estos comandos crean una y entran ahí.

Windows (PowerShell)

mkdir -Force $HOME\Code
cd $HOME\Code

macOS o Linux

mkdir -p ~/Code
cd ~/Code

Ya estando ahí, el clonado es igual en Windows, macOS y Linux. Cambia TU-USUARIO por tu usuario de GitHub:

git clone https://github.com/TU-USUARIO/workshop-altar-digital.git
cd workshop-altar-digital

⚠️ No clones dos veces

Ejecuta git clone desde tu carpeta Code, no desde una carpeta que ya se llame workshop-altar-digital. Si Git dice que el destino ya existe, detente y revisa dónde estás en vez de volver a clonar.

Después de entrar al repo, corre esto. Igual en Windows, macOS y Linux:

git remote -v

Debe imprimir dos líneas que apunten a tu usuario. También debes ver package.json en esa misma carpeta; ahí es donde corre npm install.

Instala las dependencias

Igual en Windows, macOS y Linux:

npm install

Tarda un minuto. Instala:

  • React para el frontend;
  • Vite para construirlo;
  • CDK para la infraestructura;
  • el SDK de AWS que usan los handlers.

💡 Por qué npm

npm viene con Node, así que no necesitas instalar otro gestor de paquetes.

Revisa que tu laptop esté lista

El starter trae un comando que revisa tu entorno y, si algo falta, te imprime el comando de arreglo para tu sistema operativo.

Igual en Windows, macOS y Linux:

npm run doctor

Cuando todo está bien se ve así:

  Revisión del prework — Ofrenda en la Nube

✓ Node 24.18.0
✓ git version 2.54.0
✓ npm 12.0.1
✓ AWS CLI 2.35.0
✓ Perfil de AWS: ofrenda
✓ Región: us-east-2

Todo listo. Tu laptop puede construir el altar.

Si algo falta sale con ✗ y abajo el comando exacto para instalarlo:

  • Windows: winget.
  • macOS: nvm para Node, y xcode-select para Git.
  • Linux: nvm para Node, y el gestor de paquetes de tu distro para lo demás.
Windows: la terminal no reconoce git, node o npm

El instalador cambió el PATH, pero la terminal que ya estaba abierta no se enteró. Cierra todas las ventanas de la terminal, también la terminal integrada de tu editor, abre una nueva y vuelve a correr npm run doctor.

⚠️ Si el doctor marca la Región con ✗

Significa que uno de tus perfiles de AWS no tiene Región configurada. Confirma la Región en AWS Settings y ejecuta, reemplazando TU-REGION y el perfil si hace falta:

aws configure set region TU-REGION --profile ofrenda

cdk bootstrap la necesita en el módulo 2.

Abre el proyecto en Kiro

Abre la carpeta del repo

En Kiro, ve a File → Open Folder y elige la carpeta workshop-altar-digital que acabas de clonar.

Desde aquí, si un comando falla, pégale el error a Kiro en el chat antes de esperar ayuda. Como tiene el repo abierto, puede revisar tus archivos para explicarte qué pasó.

Prende el altar

Igual en Windows, macOS y Linux:

npm run dev

Abre http://localhost:3000 y ahí está tu altar, con el set tradicional ya puesto: papel picado, velas, pan, cempasúchil, agua, sal y copal.

Pruébalo: elige un elemento en la galería de la derecha. Los tradicionales caen directo en su grada; los personales abren un panel para completar sus datos.

💡 Dónde se está guardando eso

En localStorage, o sea en este navegador y nada más. El banner arriba del altar lo dice. Acuérdate de este detalle, porque el módulo 3 arranca justo ahí.

Para apagar el servidor, Ctrl+C en la terminal. Igual en los tres sistemas.

Checkpoint

Antes de seguir, confirma que tienes todo esto

  1. Tu Región apuntada.
  2. github.com/TU-USUARIO/workshop-altar-digital abierto en una pestaña.
  3. npm run doctor sin ningún ✗.
  4. El repo abierto en Kiro.
  5. El altar cargando en http://localhost:3000.

Si te falta algo, pégale el error a Kiro. Si no se resuelve en un par de minutos, levanta la mano: en el módulo 2 todo esto se da por hecho.