用途：next-forge 是一个基于 Turborepo 的 monorepo 模板，用于搭建生产级 Next.js SaaS 应用，提供多应用与共享包结构，以及认证、数据库、支付、邮件、CMS、分析、可观测性、安全等集成。
主要能力：仓库分为 apps 与 packages。apps 为可部署应用：app（3000，主 SaaS 应用）、web（3001，带 CMS 与 SEO 的营销站）、api（3002，处理 webhook 与定时任务的无服务器 API）、email（3003，React Email 预览）、docs（3004，Mintlify 文档站）、storybook（6006）、studio（3005，Prisma Studio）。packages 作为 @repo/<name> 共享库导入，涵盖 auth、database、payments、email、cms、design-system、analytics、observability、security、storage、seo、feature-flags、internationalization、webhooks、cron、notifications、collaboration、ai、rate-limit 等。
使用方式：运行 npx next-forge@latest init 初始化，CLI 会询问项目名与包管理器（bun、npm、yarn、pnpm）。随后在 packages/database/.env 设置 DATABASE_URL（推荐 Neon 的 PostgreSQL），执行 bun run migrate 迁移，按需把可选集成密钥写入相应 .env.local，再运行 bun run dev 启动开发。常用命令包括 bun run dev、bun dev --filter app、bun run migrate、bun run lint、bun run format、bun run test、bun run build、bun run analyze。添加 shadcn/ui 组件使用 npx shadcn@latest add [component] -c packages/design-system，更新组件用 bun run bump-ui。本地 URL 已预配置为 NEXT_PUBLIC_APP_URL=http://localhost:3000 等，部署到 Vercel 时需为 app、web、api 分别建项目并指向对应 /apps 子目录，更新为生产域名。
适用场景：需要快速搭建包含营销站、主应用与 API 的 Next.js SaaS 项目，并希望统一管理认证、支付、邮件、数据库等基础设施的团队。
限制：除数据库外其他集成为可选，未设置对应环境变量时会静默禁用而非报错。环境变量通过各包的 keys.ts 结合 Zod 与 @t3-oss/env-nextjs 在构建期校验。页面与布局文件默认是服务端组件，客户端交互需放入带 'use client' 的独立文件。更详细的安装、包说明、定制与架构内容见模板内的 references 文档。