用途:当需要在基于 Supastarter 的 Next.js SaaS 应用中修改或扩展功能,并希望实现方式与真实代码库一致而非套用通用模板时使用该技能。
主要能力:提供真实的 monorepo 结构说明(apps/web、packages/api、auth、database、payments、mail、storage、ui 等);App Router 的路由分组与 provider、守卫链(营销页位于 apps/web/app/(marketing)/[locale],受保护产品路由位于 apps/web/app/(saas));生产代码中的 oRPC、Better Auth、Prisma 模式;支付、组织、设置、引导、营销、邮件、存储、分析、部署等主题参考;添加端点、页面、模型和计费流程的任务式指南;命令、导入、文件位置与环境变量速查表。
使用方式:按改动类型分类(配置、路由布局、API 后端、认证与组织、数据库与支付、UI 表单、营销内容、部署),再按需打开对应参考文档;优先复制现有模式而非另创新方案;实现类请求优先看 references/tasks/ 下的任务指南。新手建议依次阅读 monorepo 结构、导入约定、配置特性开关、TypeScript 与组件约定、文件位置速查表。正文还给出各主题的参考文件清单与最小阅读组合。
适用场景:为受保护路由添加 API 过程或仪表盘页面、新增营销页、修改认证与注册行为、调整数据模型或订阅计费、跨邮件/国际化/存储/部署的功能扩展。
限制与注意:文档明确要求不要用深层相对路径导入共享包,不要自创表单方案,不要绕过 oRPC 层,不要在已有共享查询助手时直接在应用组件中调用 Prisma,不要猜测文件位置与环境变量;应遵循分组后的最小阅读集合逐步扩展,而非一次加载全部参考文件。具体安装命令与版本信息暂未提供。