用途:为新建 Next.js 项目提供预配置的完整工程安全网,包含严格 TypeScript、类型感知 ESLint、Prettier(含 Tailwind 类名排序)、环境变量校验与测试基础设施。
主要能力:定义 src/ 目录职责,如 app/ 仅放路由与布局,features/ 放自包含功能模块,lib/ 放共享工具,components/ui/ 放 shadcn/ui 基础组件;提供 tsconfig.json(strict、noUncheckedIndexedAccess、路径别名 @/ 与 ~/)、eslint.config.ts(flat config、strictTypeChecked、自定义禁止在 src/ 直接使用 process.env)、.prettierrc、next.config.ts(构建时环境校验、standalone 输出、base path、Sentry)等配置要点。环境变量通过 t3-env 与 Zod 在构建和运行时校验,缺失或格式错误会直接导致构建失败。
使用方式:复制模板后执行 pnpm install,复制 .env.example 为 .env.local 并填写必填值,依次运行 pnpm lint、pnpm test:unit、pnpm dev 验证。常用脚本包括 dev(next dev --turbopack)、build、lint、test:unit、test:ui:headless、api:gen、mock:serve 等。
适用场景:引导新 Next.js 项目、理解项目布局,以及按需裁剪 MFE 架构、对接 API 代码生成、调整 shadcn/ui 组件。
限制:资料未提供官方定价、平台支持范围或实际使用效果数据;部分配置细节(如 Sentry、Mockoon 具体配置)需参考项目内文件,本文不展开。