next-forge

name	next-forge
description	next-forge expert guidance — production-grade Turborepo monorepo SaaS starter by Vercel. Use when working in a next-forge project, scaffolding with `npx next-forge init`, or editing @repo/* workspace packages.
summary	next-forge monorepo SaaS starter (Turborepo, Clerk, Prisma/Neon, Stripe, Resend, shadcn/ui, Sentry, PostHog). See => skill:next-forge for full guide.
metadata	{"priority":6,"docs":["https://next-forge.com/docs","https://github.com/haydenbleasel/next-forge"],"pathPatterns":["pnpm-workspace.yaml","apps/app/**","apps/web/**","apps/api/**","apps/email/**","apps/docs/**","apps/studio/**","apps/storybook/**","packages/auth/**","packages/database/**","packages/design-system/**","packages/payments/**","packages/email/**","packages/analytics/**","packages/observability/**","packages/security/**","packages/ai/**","packages/cms/**","packages/collaboration/**","packages/feature-flags/**","packages/internationalization/**","packages/notifications/**","packages/rate-limit/**","packages/seo/**","packages/storage/**","packages/webhooks/**","packages/next-config/**","packages/typescript-config/**","**/keys.ts","**/env.ts","**/proxy.ts","biome.jsonc"],"bashPatterns":["\\bnext-forge\\b","\\bnpx\\s+next-forge\\b","\\bpnpm\\s+migrate\\b","\\bpnpm\\s+bump-deps\\b","\\bpnpm\\s+bump-ui\\b","\\bprisma\\s+(generate|db\\s+push|format|studio)\\b","\\bstripe\\s+listen\\b","\\bnpx\\s+shadcn@latest\\s+add\\b.*-c\\s+packages/design-system\\b"],"importPatterns":["@repo/auth","@repo/database","@repo/design-system","@repo/payments","@repo/email","@repo/analytics","@repo/observability","@repo/security","@repo/ai","@repo/cms","@repo/collaboration","@repo/feature-flags","@repo/internationalization","@repo/notifications","@repo/rate-limit","@repo/seo","@repo/storage","@repo/webhooks","@repo/next-config","@t3-oss/env-nextjs","@rescale/nemo"],"promptSignals":{"phrases":["next-forge","next forge","@repo/"],"allOf":[["monorepo","saas","starter"],["turborepo","clerk","stripe"]],"anyOf":["saas starter","production monorepo","keys.ts","pnpm-workspace"],"noneOf":["create-t3-app"],"minScore":6}}
validate	[{"pattern":"\"pipeline\"\\s*:","message":"turbo.json \"pipeline\" was renamed to \"tasks\" in Turborepo v2 — update to \"tasks\"","severity":"error"},{"pattern":"new Pool\\(","message":"PrismaNeon expects a connection config object, not a Pool instance — use PrismaNeon({ connectionString: url })","severity":"error","skipIfFileContains":"pg\\.Pool"},{"pattern":"prisma studio --schema","message":"Prisma v7 removed --schema flag for studio — use --config instead","severity":"error"},{"pattern":"middleware\\.ts","message":"next-forge uses proxy.ts (Next.js 16+), not middleware.ts — rename to proxy.ts","severity":"warn","skipIfFileContains":"proxy\\.ts"}]
retrieval	{"aliases":["saas starter","monorepo starter","next forge","turborepo template"],"intents":["scaffold saas","set up next-forge","create monorepo project","use next-forge"],"entities":["next-forge","@repo/*","Turborepo","monorepo","SaaS starter"]}
chainTo	[{"pattern":"export\\s+(default\\s+)?function\\s+middleware","targetSkill":"routing-middleware","message":"middleware.ts detected in next-forge project — loading Routing Middleware guidance for proxy.ts migration."},{"pattern":"@clerk/|clerkMiddleware|ClerkProvider|getAuth\\(\\)|auth\\(\\)","targetSkill":"auth","message":"Clerk auth patterns in next-forge — loading Auth guidance for middleware auth, sign-in/sign-up flows, and organization handling.","skipIfFileContains":"@auth0/|@descope/"}]

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	Marketing website with CMS and SEO
api	3002	Serverless API for webhooks, cron jobs
email	3003	React Email preview server
docs	3004	Documentation site (Mintlify)
storybook	6006	Design system component workshop
studio	3005	Prisma Studio for database editing

Core Packages: auth, database, payments, email, cms, design-system, , , , , , , , , , , , , , , .