概览
从本地首次登录到自己的 Cloudflare 部署，了解模板范围和开发入口。
MuseMVP Flare 是独立的 TanStack Start + Cloudflare SaaS 源码模板。应用位于 apps/web，通过 Vite 与原生 Cloudflare 插件构建为 Worker，使用 D1、私有 R2、Email Sending、Workers AI 和 Queues。
打开在线演示。演示用于查看界面与公开流程，不提供本地 seed 账号，也不代表每个外部服务均已完成你的账户验收。
推荐阅读顺序
| 你的目标 | 从哪篇开始 | 完成后应得到什么 |
|---|---|---|
| 第一次下载 | 获取源码 | 独立仓库、正确工具链与自己的私有远端 |
| 跑起来 | 快速开始 | 可登录的本地工作台与开发邮箱 |
| 换成自己的产品 | 品牌配置 | 名称、Logo、文案、主题与套餐 |
| 准备可选服务 | 环境变量 | 区分本地、CLI 与 Worker 的配置 |
| 第一次上线 | 部署 | 自己的资源、域名、迁移和公开页面冒烟 |
| 开始写业务 | 项目结构 | 知道路由、服务、查询和 UI 应改在哪里 |
模板包含什么
- 账号：密码与邮箱验证、邮件 OTP、Google/GitHub OAuth、双因素认证、会话、API Keys 和管理员角色。
- 工作台：概览、文件、AI、账单、用量、设置、引导；管理员另有用户、订单、任务、Webhook、审计、退款和死信视图。
- 业务基础：私有文件所有权检查、积分账本、流式生成、队列摘要、Webhook inbox/outbox 与重试幂等。
- 界面与内容：应用内 shadcn/Base UI 组件、中英文 MDX、Geist/Fraunces 字体、浅色/深色/跟随系统。
- 交付工具：本地初始化、账户诊断、部署规划、命名资源部署与公开冒烟验证。
先运行，再配置外部服务
pnpm install --frozen-lockfile
pnpm muse:init
pnpm dev打开 http://localhost:3000。完整账号、端口、验证邮件和成功检查见快速开始。首次启动不要求 Cloudflare API Token，也不需要同时开通四家支付商户。
支付默认关闭。AI 没有本地模型模拟器；真实生成需要显式连接 Cloudflare。生产不开放 /dev/mail，也不创建开发管理员账号。
与其他 MuseMVP 产品的关系
MuseMVP 与 All in One 包含 Flare 源码；UI 模板方案不包含工程基座。原 musemvp 仓库保留两套 Next.js 应用，Flare 是单独仓库，不依赖它启动。
Next.js UI 模板可以提供设计与内容，但接入 Flare 时需适配路由、Link、图片与服务端组件假设。不要复制 OpenNext、PostgreSQL 或 Next.js 的目录约定到这里。
如何判断已经可以交付
公开演示可访问、源码测试通过、你的账户服务可用，是不同层次的结果。部署 CLI 的 smokePassed 只检查公开 HTTP 页面；真实注册邮件、OAuth、AI 和商户交易需要单独验证。参见测试、排障以及源码的 docs/RELEASE.md。