next-forge

Guides setup, customization, and deployment of the next-forge Turborepo Next.js SaaS template.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/sharad07072007/paras --skill next-forge-sharad07072007
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-forge
Source: https://github.com/sharad07072007/paras/tree/main/.agents/plugins/vercel/skills/next-forge/upstream
Command: npx skills add https://github.com/sharad07072007/paras --skill next-forge-sharad07072007

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a SaaS application from scratch requires wiring together authentication, payments, database, email, CMS, analytics, and security — a process that takes weeks. This Skill provides expert guidance on next-forge, a production-grade Turborepo template that pre-integrates all of these into a Next.js monorepo. ## Core Features & Use Cases - Installation & Setup Guidance: Walks through npx next-forge@latest init, environment variable configuration, and database migrations with Prisma and Neon PostgreSQL. - Architecture Reference: Explains the monorepo structure with 7 apps (app, web, api, email, docs, storybook, studio) and 20+ shared packages imported as @repo/<name>. - Customization & Provider Swapping: Documents how to replace default integrations (Clerk, Stripe, BaseHub, Resend) with alternatives like Auth.js, Paddle, or Content Collections. - Use Case: A developer wants to launch a SaaS product quickly. They use this Skill to initialize next-forge, configure Clerk authentication and Stripe payments, then deploy the app, web, and api projects to Vercel with correct environment variables. ## Quick Start Ask the assistant to help you initialize a new next-forge project and configure the database connection for local development.

Frequently Asked Questions about next-forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and set up next-forge?

Run `npx next-forge@latest init` and follow the CLI prompts for project name and package manager. Then set DATABASE_URL in packages/database/.env, run `bun run migrate` to push the Prisma schema, and start development with `bun run dev`.

How do I swap Clerk for another auth provider in next-forge?

Replace the packages/auth directory with your chosen provider such as Supabase Auth, Auth.js, or Better Auth. Update the AuthProvider in the design system package and adjust the webhook handlers in the api app accordingly.

Can I deploy next-forge apps to Vercel?

Yes, create three separate Vercel projects for the app, web, and api directories, each with its root directory set under /apps/. Use Vercel Team Environment Variables to share common values like DATABASE_URL across projects.

What happens if environment variables are missing in next-forge?

Only DATABASE_URL is required; all other integrations degrade gracefully. Clients use optional chaining like stripe?.prices.list(), so missing keys silently disable features rather than causing runtime errors.

How do I add shadcn/ui components to the next-forge design system?

Run `npx shadcn@latest add [component] -c packages/design-system` to add new components to the shared design system package. To update existing components to the latest versions, run `bun run bump-ui`.

Why does my next-forge build fail on environment validation?

Each package validates its environment variables at build time using @t3-oss/env-nextjs with Zod schemas in keys.ts files. The build fails with a descriptive error if a required variable is missing or malformed, so check the indicated package's .env file.