next-forge

name	next-forge
description	Expert assistance for next-forge — a production-grade Turborepo template for Next.js SaaS apps. Triggers on questions about next-forge installation, setup, architecture, packages, customization, deployment, and development workflows.

next-forge

next-forge is a production-grade Turborepo template for building Next.js SaaS applications. It provides a monorepo structure with multiple apps, shared packages, and integrations for authentication, database, payments, email, CMS, analytics, observability, security, and more.

Quick Start

Initialize a new project:

npx next-forge@latest init

The CLI prompts for a project name and package manager (bun, npm, yarn, or pnpm). After installation:

1. Set the DATABASE_URL in packages/database/.env pointing to a PostgreSQL database (Neon recommended).
2. Run database migrations: bun run migrate
3. Add any optional integration keys to the appropriate .env.local files.
4. Start development: bun run dev

All integrations besides the database are optional. Missing environment variables gracefully disable features rather than causing errors.

Architecture Overview

The monorepo contains apps and packages. Apps are deployable applications. Packages are shared libraries imported as @repo/<package-name>.

Apps (in /apps/):

App	Port	Purpose
app	3000	Main authenticated SaaS application
web	3001