Guía de Despliegue
Pasando a producción con Vercel.
RapidCore está construido para ser desplegado en Vercel. Dado que es un Monorepo usando Turborepo, Vercel lo maneja de forma nativa.
Estrategia de Despliegue Unificada
RapidCore es un monorepo. Para la mejor experiencia, recomendamos desplegar cada aplicación como un proyecto separado en Vercel.
URLs y Puertos de Aplicación (Local vs Prod)
| App | Puerto Local | URL de Producción (Ejemplo) |
|-----|------------|-------------------------|
| Landing | 3000 | https://rapidcore.io |
| Web Starter | 3001 | https://app.rapidcore.io |
| AI Studio | 3002 | https://ai.rapidcore.io |
| Game SaaS | 3003 | https://game.rapidcore.io |
| Docs | 3005 | https://docs.rapidcore.io |
Despliegue en Vercel Paso a Paso
-
Importar Repositorio: Importa la raíz de tu monorepo en Vercel.
-
Configuración de Proyecto para cada App:
- Framework: Next.js
- Directorio Raíz:
apps/nombre-de-tu-app - Comando de Construcción:
cd ../.. && npx turbo run build --filter=nombre-de-tu-app - Comando de Instalación:
cd ../.. && pnpm install
-
Variables de Entorno Requeridas: Asegúrate de configurar lo siguiente en Vercel para todas las aplicaciones para habilitar la navegación unificada:
NEXT_PUBLIC_URL_LANDINGNEXT_PUBLIC_URL_WEBNEXT_PUBLIC_URL_AINEXT_PUBLIC_URL_GAMENEXT_PUBLIC_URL_DOCS
Conexión a Base de Datos
Asegúrate de que tu base de datos (Supabase) sea accesible desde Vercel. Es posible que debas ajustar las "Restricciones de Red" si están habilitadas.
Configuración de Producción de Supabase
Al entrar en vivo, debes introducir las claves de producción reales en Vercel en lugar de las claves de prueba locales:
- Panel de Supabase > Configuración > API:
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEY(Para acceso público)SUPABASE_SERVICE_ROLE_KEY(Solo para operaciones autorizadas del lado del servidor)
- Conexión a la Base de Datos: Asegúrate de que los campos
DATABASE_URLyDIRECT_URLestén definidos en la sección de Variables de Entorno de Vercel.
Seguridad
Nunca definas la clave service_role con el prefijo NEXT_PUBLIC_. Esta clave elude todas las protecciones de la base de datos (RLS) y debe mantenerse estrictamente confidencial.
Lista de Verificación de Producción
- [ ]
NEXTAUTH_URLestá configurado en tu dominio de producción (por ejemplo,https://rapidcore.io). - [ ]
NEXTAUTH_SECRETes una cadena aleatoria fuerte. - [ ] Las migraciones de base de datos se han aplicado (
prisma migrate deploy). - [ ] Se ha actualizado con la clave de producción
STRIPE_WEBHOOK_SECRET. - [ ] El punto final del Webhook de Stripe está actualizado a la URL de producción.