Next-forge SaaS 模板
给一个 Next.js SaaS 项目或报错现象,产出 next-forge 单体仓库的目录结构、集成配置与命令清单。
功能与用途
next-forge 是 Vercel 官方的 Turborepo 单体仓库 SaaS 起步模板,一次带齐认证、数据库、支付、邮件、CMS、分析、可观测性、安全等集成。这个能力用来解读它的结构:apps 下有 app/web/api/email/docs/studio 等可部署应用,packages 下是 @repo/* 共享包,环境变量通过 keys.ts 用 Zod 校验。缺数据库之外的变量不会报错,功能会被静默关闭。
适用场景
- 初始化 SaaS 单体仓库:使用脚手架快速生成集成认证、数据库与支付的多应用 Turborepo 骨架。
- 维护 @repo/* 共享包:在 shared package 中配置 Zod 校验环境变量与通用逻辑,供前后端应用直接引用。
- 跨应用联调与数据库迁移:管理主应用、营销页与 API 服务的本地端口联调,并集中执行 Prisma 数据迁移。
适用人群
- 用 Next.js 做 SaaS 产品的全栈开发
- 需要搭单体仓库的创业团队技术负责人
- 刚接手 next-forge 项目要快速上手的新成员
使用步骤
- 说明你手上的 next-forge 项目状况:目录位置、要改的 app 或 package、报错信息
- 确认架构归属,判断改动落在 apps/* 还是 packages/@repo/*,以及涉及哪个 keys.ts 环境变量文件
- 按给出的命令执行改动,如 bun run migrate 跑 Prisma 迁移、npx shadcn@latest add 加组件到 design-system
- 核对环境变量是否齐备、NEXT_PUBLIC_*_URL 是否指向正确端口,缺变量时确认该功能是被优雅禁用还是需要补齐
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
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.
使用前准备
- 本地或仓库里已有 next-forge 项目,或准备用 npx next-forge@latest init 初始化
- 需要 Node/pnpm 或 bun 环境与 PostgreSQL 数据库
依赖与权限
- DATABASE_URL
- NEXT_PUBLIC_APP_URL
- NEXT_PUBLIC_WEB_URL
- NEXT_PUBLIC_API_URL
- NEXT_PUBLIC_DOCS_URL
- 读取用户主动提供的内容