Introduction & Quick Start

Welcome to the future of SaaS development.

RapidCore is not just another boilerplate. It is a production-ready monorepo factory designed for serious developers who want to build, scale, and sell high-performance SaaS applications. Whether you are building a simple B2B dashboard, an AI-powered creative tool, or a competitive multiplayer game, RapidCore provides the optimized foundation you need.

Why Monorepo?

RapidCore separates concerns into distinct applications (apps/web-starter, apps/ai-starter, apps/game-starter) sharing a common packages/core (Database/Auth) and packages/ui (Design System). This ensures your code remains clean and maintainable as you scale.

⚡ 5-Minute Quick Start

Follow these steps to launch your empire.

1. Installation

Clone the repository and install dependencies using pnpm.

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

2. Environment Setup

Copy the example environment file and generate your secrets.

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

3. Launch the Development Hub

Start all applications (Web, AI, Game, Docs) in parallel mode.

npx pnpm dev

You can now access:

Landing & Web SaaS: http://localhost:3001
AI Studio: http://localhost:3002
Game Engine: http://localhost:3003
Documentation: http://localhost:3000

Architecture Overview

RapidCore uses TurboRepo to manage the build pipeline.

apps/: The consumer facing applications.
packages/: Shared internal libraries.
- ui: Shadcn/ui + Tailwind v4 components.
- core: Prisma, Auth.js, and shared business logic.
- config: TypeScript and ESLint configurations.

The greatest strength of RapidCore is that it shares Business Logic within packages/core across all applications.

Shared Models: Your database schema (prisma.schema) is defined centrally, and all projects in the apps/ folder use the same TypeScript types.
Logic Imports: For example, you can write the logic to award a badge (awardBadge) once in core and use it in both the Game module and the Web user profile page.

// From any app (web, ai, game)
import { awardBadge } from "@rapidcore/core";

Senior Tip

If you are going to use business logic in more than one application, be sure to move it into packages/core to prevent code duplication. This will make the maintenance of your project incredibly easy.

Ready to customize? Check out the next Configuration guide.