Instalación local

1. Prepare su computadora y abra el proyecto.

Primero complete Antes de comenzar: acepte la invitación GitHub, instale Node.js 22 o posterior, Git, un editor y Corepack, luego clone su repositorio web o el monorepo de todas las plataformas. Abra la carpeta supastack en el editor y seleccione Terminal → Nueva terminal. Deberías ver package.json en la lista de archivos de nivel superior del editor. Todos los comandos siguientes se ejecutan desde la raíz de este repositorio.

Esto inicia la demostración local sin cuentas en AI, proveedores de facturación o correo electrónico y sin Docker. Permita tiempo adicional para las descargas de dependencias por primera vez. Siga solo el bloque de Windows o solo el bloque de macOS/Linux en los siguientes pasos; no ejecute ambos.

• Instale las herramientas y obtenga el código
• Aprenda a ejecutar un comando y editar un archivo

2. Cree archivos de configuración: macOS/Linux

En su terminal, ejecute cada línea a continuación. La primera copia crea .env para comandos de migración posteriores. El segundo crea apps/web/.env.local, que el servidor web realmente lee. Ambos contienen la configuración local del ejemplo. Si alguno de los archivos de destino ya existe, consérvelo y omita el comando de copia; no sobrescriba las configuraciones guardadas. Los usuarios de Windows utilizan la siguiente sección.

corepack pnpm install descarga las bibliotecas que necesita la aplicación. Si Corepack solicita descargar pnpm, responda y. Espere hasta que termine y vuelva el mensaje del terminal. Un mensaje final Done sin error significa que puede continuar.

cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install

2. Cree archivos de configuración: Windows PowerShell

Utilice estos comandos en PowerShell desde la carpeta que contiene paquete.json. Si .env o apps/web/.env.local ya existe, omita la línea de copia y mantenga su configuración. Espere a que finalice la instalación antes de iniciar el servidor. Si la ejecución del script está bloqueada, use corepack.cmd en lugar de corepack como se explica en Antes de comenzar.

Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install

3. Inicie el servidor web; deje esta terminal abierta

Ejecute el siguiente comando desde la raíz del repositorio. Solo inicia la aplicación web, por lo que funciona tanto en el repositorio solo web como en el monorepo de todas las plataformas. Espere a que la terminal muestre Local: http://localhost:3000 y Ready. La primera página puede tardar un poco más en compilarse. La terminal debería seguir funcionando; eso se espera.

En el monorepo de todas las plataformas, corepack pnpm dev inicia juntos los espacios de trabajo de desarrollo disponibles. Si apps/docs está presente, esa aplicación de documentos separada usa http://localhost:3001.. Las guías públicas que está leyendo son parte de la aplicación web en http://localhost:3000/docs.. No necesita el puerto 3001 para seguir este tutorial.

corepack pnpm --filter @supastack/web dev

4. Abra la aplicación y complete una tarea local.

En la barra de direcciones de su navegador, abra http://localhost:3000 para ver la página de inicio. Luego abra http://localhost:3000/dashboard.. Mantenga el nombre y el correo electrónico precargados, o ingrese sus propios valores de prueba y haga clic en Start local reference flow. Esto crea un espacio de trabajo de demostración en memoria; no crea una cuenta persistente ni envía un correo electrónico real.

En la demostración, abra AI task desde la barra lateral, ingrese una solicitud breve como Resumir los criterios de aceptación local y haga clic en Queue local task. Cuando su estado esté en cola, haga clic en Run local task y luego en View result. Debería ver el resultado completo y un estado Email queued. La respuesta de la IA es deliberadamente falsa y repetible; el correo electrónico en cola es local. Al reiniciar el servidor se borran estos datos de demostración.

Para usar /auth para un registro real, primero inicie Postgres y aplique las migraciones usando la guía de bases de datos y migraciones. Después de eso, los mensajes de registro o OTP de EMAIL_PROVIDER=local se pueden inspeccionar en http://localhost:3000/mail-preview; y no llegan a una bandeja de entrada externa. El inicio de sesión móvil también utiliza esta autenticación respaldada por una base de datos, en lugar de la sesión de demostración.

• Agregar Postgres y cuentas persistentes

5. Detenga, reinicie y solucione problemas comunes de primera ejecución

El éxito significa que se carga la página de inicio, se abre el espacio de trabajo local y se completa una tarea en cola. Cuando termine, haga clic en la terminal del servidor y presione Ctrl + C. Para continuar más tarde, vuelva a abrir una terminal en la raíz del repositorio y repita el comando del servidor desde el paso 3; no reinstale las dependencias cada vez.

Si localhost:3000 no se abre, verifique que la terminal del servidor aún esté ejecutándose y muestre Ready. Si el puerto 3000 está en uso, detenga el otro servidor de desarrollo con Ctrl + C y vuelva a intentarlo. Si ve un error de base de datos después de abrir /auth, regrese a /dashboard para ver la demostración o completar la guía de la base de datos. Si falta la demostración local, verifique APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local y JOB_PROVIDER=local en apps/web/.env.local y luego reinicie.

Para personalizar el nombre y el texto de marketing, abra apps/web/src/marketing/site-config.ts en el editor. Siga Branding para conocer los campos exactos y los pasos de verificación. Para la configuración de apariencia de la cuenta real, primero complete la configuración de la base de datos y luego abra /settings/appearance. Los comandos de aceptación automatizados tardan más que este tutorial de primera ejecución; encuéntrelos en Comandos del espacio de trabajo.

• Corregir un error de primera ejecución
• Cambie el nombre y la copia de su producto