Introducción e Inicio Rápido

Bienvenido al futuro del desarrollo SaaS.

RapidCore no es solo otro boilerplate. Es una fábrica de monorepo lista para producción diseñada para desarrolladores serios que desean construir, escalar y vender aplicaciones SaaS de alto rendimiento. Ya sea que estés construyendo un simple panel B2B, una herramienta creativa impulsada por IA o un juego multijugador competitivo, RapidCore proporciona la base optimizada que necesitas.

¿Por qué Monorepo?

RapidCore separa las preocupaciones en distintas aplicaciones (apps/web-starter, apps/ai-starter, apps/game-starter) que comparten un packages/core (Base de datos/Autenticación) y packages/ui (Sistema de Diseño) comunes. Esto asegura que tu código permanezca limpio y mantenible a medida que escalas.

⚡ Inicio Rápido en 5 Minutos

Sigue estos pasos para lanzar tu imperio.

1. Instalación

Clona el repositorio e instala las dependencias usando pnpm.

git clone https://github.com/rapidcore/rapidcore-monorepo.git
cd rapidcore-monorepo
pnpm install

2. Configuración del Entorno

Copia el archivo de entorno de ejemplo y genera tus secretos.

cp .env.example .env
npx rapid-init secrets

3. Lanzar el Centro de Desarrollo

Inicia todas las aplicaciones (Web, IA, Juego, Documentación) en modo paralelo.

npx pnpm dev

Ahora puedes acceder a:

Landing & Web SaaS: http://localhost:3001
Estudio de IA: http://localhost:3002
Motor de Juego: http://localhost:3003
Documentación: http://localhost:3000

Descripción General de la Arquitectura

RapidCore utiliza TurboRepo para gestionar el flujo de construcción.

apps/: Las aplicaciones orientadas al consumidor.
packages/: Bibliotecas internas compartidas.
- ui: Componentes Shadcn/ui + Tailwind v4.
- core: Prisma, Auth.js y lógica de negocio compartida.
- config: Configuraciones de TypeScript y ESLint.

Uso Compartido de Datos y Lógica Entre Módulos (Turborepo)

La mayor fortaleza de RapidCore es que comparte la lógica de negocio (Business Logic) dentro de packages/core entre todas las aplicaciones.

Modelos Compartidos: Tu esquema de base de datos (prisma.schema) se define de forma centralizada y todos los proyectos de la carpeta apps/ utilizan los mismos tipos de TypeScript.
Importaciones de Lógica: Por ejemplo, puedes escribir la lógica para otorgar una recompensa (awardBadge) una vez en core y utilizarla tanto en el módulo de Juego como en la página de perfil de usuario en la Web.

// Desde cualquier aplicación (web, ai, game)
import { awardBadge } from "@rapidcore/core";

Consejo Senior

Si vas a utilizar una lógica de negocio en más de una aplicación, asegúrate de moverla a packages/core para evitar la duplicación de código. Esto facilitará enormemente el mantenimiento de tu proyecto.

¿Listo para personalizar? Consulta la guía de Configuración a continuación.