next-forge

Guides development and customization of next-forge Turborepo monorepo SaaS applications.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill next-forge-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-forge
Source: https://github.com/AarnavBaddam/skills/tree/main/next-forge
Command: npx skills add https://github.com/AarnavBaddam/skills --skill next-forge-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working in a next-forge monorepo means navigating seven apps, over twenty shared @repo packages, and integrations like Clerk, Stripe, Prisma, and BaseHub. This Skill provides the architectural knowledge and command reference needed to scaffold, configure, and extend a next-forge project without digging through scattered documentation. ## Core Features & Use Cases - Monorepo Navigation: Explains the apps/ and packages/ structure, Turborepo pipeline tasks, port assignments, and the @repo/* import conventions. - Setup & Environment Guidance: Walks through npx next-forge init, DATABASE_URL configuration, optional integration keys, and the keys.ts validation pattern using @t3-oss/env-nextjs. - Provider Swapping & Extension: Documents how to replace Clerk, Stripe, Prisma, BaseHub, or Resend with alternatives, add new apps, packages, cron jobs, webhooks, and feature flags. - Use Case: You scaffold a SaaS with npx next-forge init, then ask how to swap Stripe for Paddle and add a new cron job — the Skill points you to packages/payments, the webhook handler in apps/api, and the vercel.json schedule format. ## Quick Start Ask the assistant to explain the next-forge monorepo structure or how to run database migrations after editing the Prisma schema.

Frequently Asked Questions about next-forge

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

FAQPage Schema
How do I set up a next-forge project locally?

Run npx next-forge@latest init, choose a project name and package manager, then set DATABASE_URL in packages/database/.env pointing to a PostgreSQL database. Run bun run migrate to push the Prisma schema, then bun run dev to start all apps.

How do I run database migrations in a Turborepo monorepo with Prisma?

Edit packages/database/prisma/schema.prisma, then run bun run migrate from the repo root. This executes prisma format, prisma generate, and prisma db push in sequence against the DATABASE_URL.

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

Yes, next-forge is modular. Replace the packages/auth directory with Supabase Auth, Auth.js, or Better Auth, then update the AuthProvider in the design system and the webhook handlers in the api app.

What happens if optional 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 the feature instead of throwing errors.

How do I add shadcn/ui components to the design system package?

Run npx shadcn@latest add [component] -c packages/design-system from the repo root. To update all existing components to the latest versions, run bun run bump-ui.

How do I deploy next-forge apps to Vercel?

Create three separate Vercel projects with root directories apps/app, apps/web, and apps/api. Add environment variables per project or use Vercel Team Environment Variables, and update the NEXT_PUBLIC_*_URL variables to production domains.