> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Introducción

Qué es supastack, qué obtienes y el camino hasta una app en ejecución.

## Empieza aquí: lo que has recibido

El kit es una aplicación inicial que puedes personalizar. Web es la interfaz del navegador más el servidor API; El móvil es la interfaz del teléfono; El escritorio es una ventana nativa que muestra la aplicación web. Un API es la dirección del servidor a la que llama un cliente para iniciar sesión o leer datos. Los paquetes compartidos son piezas reutilizables que utilizan estas aplicaciones.

Comience con el tutorial local web a continuación. Le indica exactamente cómo descargar bibliotecas, iniciar el servidor y ejecutar un AI task falso. Luego agregue la base de datos para las cuentas guardadas, elija solo los proveedores que su producto necesita, personalice su marca y prepare el hosting. Puedes leer las explicaciones técnicas más adelante; no son requisitos previos para abrir la primera demostración.

[Instale las herramientas y obtenga el código](https://supastack.dev/es/docs/web/before-you-start.md)

[Aprenda a ejecutar un comando y editar un archivo](https://supastack.dev/es/docs/web/terminal-basics.md)

[Siga el tutorial web completo de primera ejecución](https://supastack.dev/es/docs/web/ship-in-5-minutes.md)


## Construye sobre una base compartida

supastack es una base modular para crear productos SaaS con IA en web, móvil y escritorio. Next.js aloja la interfaz web y la API, Expo ofrece flujos de referencia nativos y la aplicación de escritorio de Tauri carga la misma aplicación web. Los paquetes compartidos se ocupan de la identidad, los espacios de trabajo, la facturación, la IA, los trabajos, el correo electrónico, el almacenamiento y la observabilidad.

Empieza con el flujo de referencia local para entender cómo encajan los módulos. Configura los proveedores de producción solo cuando ese flujo funcione en tu entorno.


## Encuentra lo que buscas

Las aplicaciones combinan los paquetes compartidos. Las funciones específicas del producto pertenecen al código base del producto que los consume, no al núcleo reutilizable.

```
apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery
```


## Elige tu punto de partida

Empieza con la configuración local de cinco minutos. Después, sigue el enlace Continuar con la configuración al final de cada guía: configura la base de datos, la autenticación, los planes y los proveedores antes de preparar el despliegue. Usa el índice completo de documentación para encontrar todas las funciones, los proveedores, los componentes y las referencias.

El recorrido local principal ha superado las pruebas en el entorno de desarrollo del proyecto. La configuración cronometrada desde un clon limpio, la prueba rápida con proveedores reales, el despliegue y la aceptación en dispositivos físicos son pasos de verificación independientes.

[Configuración local en cinco minutos](https://supastack.dev/es/docs/web/ship-in-5-minutes.md)

[Examinar toda la documentación](https://supastack.dev/es/docs/web/project-structure.md)

[Configuración móvil](https://supastack.dev/es/docs/mobile/ship-in-5-minutes.md)

[Configuración de escritorio](https://supastack.dev/es/docs/desktop/ship-in-5-minutes.md)

[Aprende a navegar esta documentación](https://supastack.dev/es/docs/web/using-the-docs.md)


## Bienvenido a supastack

supastack es un kit modular para productos SaaS con IA: una app web Next.js, una app móvil Expo y una shell de escritorio Tauri, todo construido sobre paquetes TypeScript compartidos de auth, facturación, IA, jobs, email, almacenamiento y observabilidad.

Tras la compra recibes una invitación de GitHub a los repositorios del kit — web, móvil y escritorio (el paquete All Platforms entrega el monorepo completo). Clona la superficie que vas a lanzar y hazla tuya.

Esta documentación es un camino paso a paso, no un volcado de referencia: primero pon la app en marcha en local y luego recorre las páginas de configuración de proveedores en orden. Cada página termina apuntando a la siguiente.


## Arranca un servidor local

Necesitas Node.js 22 o superior. El repo fija su gestor de paquetes (packageManager: pnpm@11.19.0), así que ejecuta pnpm a través de Corepack — sin instalación global.

1. Copia el archivo de entorno para crear tu configuración local.

2. Instala las dependencias del workspace.

3. Opcionalmente arranca el contenedor Postgres local para persistencia real — los valores por defecto funcionan sin él.

4. Arranca el servidor de desarrollo y abre http://localhost:3000.

```
cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000
```


## El archivo .env

La configuración del entorno elige el servicio local o alojado utilizado por el kit. Copie .env.example a la raíz .env para las migraciones y a apps/web/.env.local para el servidor web. Expo usa apps/mobile/.env.local. Copiar solo el .env raíz no configura todas las aplicaciones.

Los proveedores falsos/locales predeterminados no necesitan credenciales API pagas. Le permiten completar la demostración en memoria/panel de control; El inicio de sesión real en /auth aún necesita PostgreSQL y migraciones. Para un proveedor real, cambie solo la configuración denominada en el archivo de configuración web, guarde, luego detenga y reinicie el servidor. Nunca exponga secretos a través de los valores NEXT_PUBLIC_ o EXPO_PUBLIC_.


## Elige tu camino

¿Nuevo aquí? «Lanza en 5 minutos» te lleva del clon a una app en ejecución solo con los valores por defecto.

¿Construyes para teléfono o escritorio? Las pestañas Móvil y Escritorio cubren las superficies Expo y Tauri. Cuando la app esté en marcha, el grupo «Configurar proveedores» recorre cada integración documento a documento.


Si quieres continuar la configuración, lee [Lanza en 5 minutos](https://supastack.dev/es/docs/web/ship-in-5-minutes.md).


## Siguiente

[Lanza en 5 minutos](https://supastack.dev/es/docs/web/ship-in-5-minutes.md)
