Saltar al contenido
supastack
Explorar la documentación
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/web/tech-stack.md (or send Accept: text/markdown).

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.

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 16 con el App Router y los server components de React 19.

TypeScript + Turborepo

El modo estricto de TypeScript se aplica en todo el espacio de trabajo pnpm, y Turborepo coordina las compilaciones.

Better Auth

Better Auth es el motor de identidad; hay un motor Auth.js disponible para los equipos que se estandaricen en él.

Drizzle + PostgreSQL

La persistencia pasa por el ORM Drizzle sobre PostgreSQL: el esquema y las utilidades por los que fluye cada registro.

Facturación

La facturación con Stripe es la opción predeterminada y se incluye un adaptador de Lemon Squeezy.

Trigger.dev

Los trabajos en segundo plano se ejecutan en Trigger.dev.

Correo transaccional

El correo transaccional se envía a través de Resend o AWS SES.

Sentry + PostHog

La observabilidad se apoya en Sentry y PostHog.

Expo

La app móvil Expo 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.

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

Preguntas frecuentes

14 preguntas

¿Qué es supastack?

supastack es una base modular para construir productos SaaS con IA. Reúne la infraestructura común para que puedas centrarte en las funciones propias de tu producto.

¿Soporta web y móvil?

Sí. supastack incluye apps Next.js y Expo como puntos de partida para experiencias web y móviles.

¿Qué autenticación incluye?

Better Auth cubre correo/contraseña, OTP e inicio social. Los espacios de trabajo personales se aprovisionan con la cuenta para que los registros permanezcan delimitados desde el primer día.

¿Cómo se soporta la IA?

supastack incluye IA multi-proveedor configurable, seguimiento de uso, presupuestos y soporte cifrado de claves propias (BYOK).

¿Cómo se gestionan las suscripciones?

Para productos construidos sobre el kit, la facturación Stripe, las suscripciones y los permisos forman la base del acceso de pago. Los secretos de proveedor permanecen en el servidor.

¿Dónde vive el código propio de mi producto?

Las funciones propias del producto permanecen en un codebase separado, mientras el producto configura e integra los módulos base de supastack.

¿Cómo funciona el precio de supastack?

El kit es una compra única con actualizaciones de por vida: Un framework a 249 $ (precio de lanzamiento temporal — 100 $ de descuento sobre el precio habitual de 349 $) o Todos los frameworks (Next.js, iOS, Android) a 499 $ (precio de lanzamiento temporal — 100 $ de descuento sobre el precio habitual de 599 $), más 75 $ por plaza de desarrollador adicional. Sin suscripción al kit. El pago en este sitio entrega tu clave de licencia por correo, con acceso al repositorio por invitación de GitHub.

¿Cómo delimitan los espacios de trabajo mis datos?

Los registros del usuario se delimitan por workspaceId. Identidad, permisos, uso de IA, eventos de facturación y entradas de auditoría permanecen dentro del límite del espacio personal.

¿Cómo funcionan los jobs en segundo plano?

Trigger.dev es el runtime de jobs explícito. El contrato JobRunner solo promete enqueue, status y cancel — la semántica de workflow sigue siendo específica y explícita de Trigger.dev.

¿En qué se diferencia el email de la divulgación?

El email transaccional cubre flujos de producto como avisos de finalización de tareas. La divulgación en frío y las campañas pertenecen al producto, fuera del módulo de email de este kit.

¿Cómo funcionan las compras móviles?

La app móvil incluye compras nativas y restauración con RevenueCat, con acceso verificado por tu servidor. Configura las cuentas de las tiendas y completa las pruebas en dispositivos antes de publicar. La facturación web es independiente.

¿Dónde residen las claves de los proveedores de IA?

Las credenciales BYOK están cifradas y permanecen en el servidor. Las claves se saneen en los logs; el uso y los presupuestos siguen visibles a nivel de espacio de trabajo.

¿Qué métodos de pago acepta el checkout?

El checkout alojado en Stripe acepta tarjetas y, una vez activadas las billeteras en la cuenta de Stripe, también puede ofrecer Alipay y WeChat Pay — muy útil para compradores en China. Las autorizaciones de billetera se confirman de forma asíncrona, por lo que la página de la licencia se actualiza en cuanto se liquida el pago.

¿Puedo obtener un reembolso?

Una vez que tienes acceso al repositorio, supastack es tuyo para siempre, por lo que no se puede reembolsar. Pero no te preocupes: obtienes el código fuente completo con actualizaciones de por vida para crear y lanzar productos ilimitados para ti o tus clientes. Solo no puedes revender el código ni redistribuir el repositorio como plantilla o starter kit.

ES
Tema