Setup
Qué instalar (checklist)
Todo lo que necesitas tener antes de correr el repo, en una lista.
Ya tienes el repo clonado. Antes de correr yarn dev, revisa esta lista. Marca cada casilla; cuando estén todas, estás listo.
Si prefieres el recorrido guiado paso a paso, ve a Quick start. Esta página es la lista de verificación para tenerlo todo a la mano.
1 · Programas en tu computadora
¿Primera vez y no sabes cómo instalarlos?
Los pasos exactos cambian según tu equipo. Sigue la guía por sistema operativo: Prepara tu compu (Mac / Windows).
- Node 20 o 22 LTS — descarga aquí. Usa una versión par (LTS). El repo trae un
.nvmrc: con nvm correnvm usey toma la correcta. - yarn 1.x — después de instalar Node:
npm install -g yarn - Git — normalmente ya viene; verifica con
git --version. - Cursor — cursor.com. Es el editor con IA que usarás para construir.
Verifica que todo quedó bien:
node --version # v20.x o v22.x
yarn --version # 1.22.x
git --versionNo mezcles npm y yarn
Este repo usa yarn (hay un yarn.lock). Instala siempre con yarn install, nunca con npm install, o se te romperán las dependencias.
2 · Cuentas en servicios externos
Todas tienen tier gratuito. Crea las tres primeras hoy; las otras dos cuando lleguen en el temario.
- GitHub — donde vive tu repo. (Ya lo tienes si clonaste.)
- Supabase — base de datos + auth. Login con GitHub.
- Vercel — para publicar tu app. Login con GitHub.
- OpenAI — para las features de IA (Sem 3+). Opcional ahora.
- Resend — para enviar emails (Sem 1+). Opcional ahora.
Detalle de qué es cada una: Cuentas que necesitas.
3 · Dependencias del proyecto
Desde la raíz del repo:
yarn install-
yarn installterminó sin errores (tarda 1–2 min la primera vez).
4 · Variables de entorno
cp web/.env.example web/.env.local- Creaste
web/.env.localcopiando el ejemplo. - Pegaste las 3 keys de Supabase (
NEXT_PUBLIC_SUPABASE_URL,NEXT_PUBLIC_SUPABASE_ANON_KEY,SUPABASE_SERVICE_ROLE_KEY).
De dónde sale cada key: Variables de entorno.
Nunca subas .env.local a git
Ya está en .gitignore. La service_role key es como la llave maestra de tu base de datos: no la compartas ni la pegues en el navegador.
5 · Corre el proyecto
yarn dev- Abre localhost:3000 — ves tu landing.
- Abre localhost:3000/docs — ves estas docs.
✅ Node, yarn y Cursor instalados.
✅ Cuentas de GitHub, Supabase y Vercel creadas.
✅ yarn install corrió sin errores.
✅ web/.env.local con las keys de Supabase.
✅ yarn dev levanta la landing en localhost:3000.
¿Algo falla? → Troubleshooting.
¿Y ahora?
→ Sigue con el Quick start para personalizar tu producto y hacer tu primer deploy.