> ## 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

# Stack tecnológico

Las tecnologías detrás del kit y el papel que juega cada una.

## Antes de comenzar

Abra su proyecto supastack descargado en Visual Studio Code usando Archivo → Abrir carpeta, luego elija Terminal → Nueva terminal. La raíz del repositorio es la carpeta que contiene package.json, aplicaciones y paquetes. Ejecute el comando a continuación y deje su terminal abierta. Si no se reconoce un comando, finalice la guía de instalación de la herramienta antes de continuar.

Lea primero el tutorial de la plataforma. Un servidor es el proceso de la aplicación que responde a las solicitudes del navegador o del teléfono. La web lee apps/web/.env.local, Expo lee apps/mobile/.env.local y los comandos de migración de bases de datos leen root .env. La demostración sin base de datos/panel de control está separada de las cuentas reales/de autenticación, que necesitan migrar Postgres. Un proceso de pago solo por teléfono o computadora de escritorio necesita un backend web que se ejecute por separado.

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

[Aprender comandos, archivos y configuración](https://supastack.dev/es/docs/web/terminal-basics.md)

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

```
corepack pnpm --filter @supastack/web dev
```


## Stack de la aplicación

La aplicación web es una aplicación Next.js compuesta por paquetes TypeScript compartidos — los mismos paquetes alimentan la app móvil Expo. El chrome del producto usa módulos CSS sobre tokens de diseño, así que no hay CSS-in-JS en runtime que depurar, y el almacenamiento de objetos es compatible con S3. Las herramientas siguientes son los valores predeterminados elegidos.


## Next.js + React

La aplicación web funciona con [Next.js](https://nextjs.org) 16 con el App Router y los server components de [React](https://react.dev) 19.

- [Next.js](https://nextjs.org)
- [React](https://react.dev)


## TypeScript + Turborepo

El modo estricto de [TypeScript](https://www.typescriptlang.org) se aplica en todo el espacio de trabajo pnpm, y [Turborepo](https://turborepo.com) coordina las compilaciones.

- [TypeScript](https://www.typescriptlang.org)
- [Turborepo](https://turborepo.com)


## Better Auth

[Better Auth](https://better-auth.com) es el motor de identidad; hay un motor Auth.js disponible para los equipos que se estandaricen en él.

- [Better Auth](https://better-auth.com)


## Drizzle + PostgreSQL

La persistencia pasa por el ORM [Drizzle](https://orm.drizzle.team) sobre [PostgreSQL](https://www.postgresql.org): el esquema y las utilidades por los que fluye cada registro.

- [Drizzle](https://orm.drizzle.team)
- [PostgreSQL](https://www.postgresql.org)


## Facturación

La facturación con [Stripe](https://stripe.com) es la opción predeterminada y se incluye un adaptador de [Lemon Squeezy](https://www.lemonsqueezy.com).

- [Stripe](https://stripe.com)
- [Lemon Squeezy](https://www.lemonsqueezy.com)


## Trigger.dev

Los trabajos en segundo plano se ejecutan en [Trigger.dev](https://trigger.dev).

- [Trigger.dev](https://trigger.dev)


## Correo transaccional

El correo transaccional se envía a través de [Resend](https://resend.com) o AWS SES.

- [Resend](https://resend.com)


## Sentry + PostHog

La observabilidad se apoya en [Sentry](https://sentry.io) y [PostHog](https://posthog.com).

- [Sentry](https://sentry.io)
- [PostHog](https://posthog.com)


## Expo

La app móvil [Expo](https://expo.dev) consume los mismos paquetes TypeScript, por lo que los cambios de contrato se verifican a la vez en ambas superficies. Expo compila para iOS y Android.

- [Expo](https://expo.dev)


## Módulos compartidos

Cada capacidad transversal vive en un paquete con un contrato pequeño: auth, db, billing, ai, jobs, email, storage, observability, config, i18n y api. Las aplicaciones los componen; la lógica de dominio del producto queda fuera del kit.

Cada módulo respaldado por un proveedor incluye un adaptador fake o local para que el ciclo de prueba y desarrollo por defecto nunca llame a un servicio de pago.


## Herramientas de verificación

Vitest cubre el comportamiento unitario e de integración, Playwright cubre los flujos de navegador, y ESLint más Prettier mantienen el código consistente. La suite determinista corre sin credenciales de proveedor; la aceptación con proveedores reales es una ruta separada y opcional.

```
corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows
```


## Siguiente

[Instalación local](https://supastack.dev/es/docs/web/local-setup.md)