（2875期）Stack Scaffold – 现代全栈 SaaS 一键启动器

现代全栈 SaaS 一键启动器 一键生成基于 Next.js App Router + Supabase + Firebase Auth 的现代化全栈项目脚手架，集成类型安全、测试框架与部署配置 使用说明 核心功能 stack-scaffold 是一款面向全栈开发者的高阶脚手架技能，专注于快速启动生产级 SaaS 项目。它一次性完成从项目初始化到部署就绪的完整工程化配置，显著降低技术栈整合的决策成本与重复劳动。 技术架构 前端：Next.js 15+ App Router、TypeScript、Tailwind CSS 后端服务：Supabase（PostgreSQL + Realtime）、Firebase Auth（身份认证） 部署与运维：Vercel（边缘部署）、Cloudflare（DNS + 安全防护） 状态管理：Zustand + 服务端 Cookie 同步 测试体系：Vitest（单元测试）+ Playwright（E2E 测试） 显著优势 安全优先设计：强制 Planning Protocol 避免误操作，明确禁止读取现有 .env 文件 类型安全贯穿：Supabase 类型自动生成、Zod 验证、Firebase Admin SDK 服务端隔离 现代化工程实践：Turbopack 开发、Prettier/ESLint 预配置、Git 自动化提交 扩展性良好：模块化目录结构，预留 (auth)、(dashboard) 路由组与 UI 组件分层 潜在局限 双认证复杂度：同时使用 Firebase Auth 与 Supabase Auth 需理解 Session 同步机制 环境变量繁多：13+ 个必需配置项，新手易遗漏 Vendor 锁定：深度绑定 Vercel/Cloudflare 生态，迁移成本较高 无 ORM 抽象：直接使用 Supabase Client，复杂查询需手写 SQL 适用人群 需快速验证 MVP 的独立开发者与初创团队 熟悉 React 生态、追求类型安全的中高级前端工程师 计划使用 Firebase + Supabase 组合的技术负责人 风险提示 密钥管理：FIREBASEPRIVATEKEY 含换行符，需正确处理 .replace(/\\n/g, "\n") 转换 中间件性能：middleware.ts 每次请求调用 supabase.auth.getUser()，高并发需评估边缘函数冷启动 数据库迁移：自动生成的 profiles 表依赖 Supabase Auth 触发器，需手动配置 RLS 策略同步 原始说明 Scaffolds a full-stack project with Next.js App Router, Supabase, Firebase Auth, Vercel, and Cloudflare