用途:在修改或扩展基于 Supastarter 的 Next.js SaaS 应用时,让实现贴合真实代码库,而非通用样板。
主要能力:提供该项目的 monorepo 结构、App Router 布局与 provider 链、oRPC + Better Auth + Prisma 的生产代码模式,以及支付、组织、设置、引导、营销、邮件、存储、分析与部署的参考;还包含添加端点、页面、模型与计费流程的任务指南。
使用方式:先分类改动(配置、路由、API/后端、认证/组织、数据库/支付、UI/表单、营销/内容、部署),再从参考文件列表中打开对应文件,复制现有模式而非自创;实现类请求优先看 references/tasks/ 下的任务指南,命令、导入、文件位置与环境变量用 cheatsheet 查询。新接触代码库时按顺序读 monorepo-structure.md、import-conventions.md、config-feature-flags.md、typescript-patterns.md、component-patterns.md、file-locations.md。
架构要点:apps/web 为 Next.js App Router 应用,packages/api 为 Hono + oRPC API,packages/auth 为 Better Auth,packages/database 为 Prisma,packages/payments 为计费与 Stripe 实现,packages/mail、storage、ui 分别负责邮件、S3 兼容签名 URL 与通用组件。营销页位于 apps/web/app/(marketing)/[locale],受保护产品路由位于 apps/web/app/(saas)。
限制:技能文件按主题拆分为多个小参考,不应盲目全量加载,从最小相关集合开始按需扩展;避免深相对路径导入、另起表单方案、绕过 oRPC、在组件中直连 Prisma、臆测文件位置或硬编码环境假设。其他具体功能与收费信息暂未提供。