代码模板指南
01MVP Start 以 Muse 为样板产品，提供账号、支付、AI、国际化和部署底座，适合快速启动一个真实 Web 产品。
01MVP Start 是一套面向独立开发者和小团队的全栈项目代码模板。文档以 products/muse 为例：一个包含 AI 工具、数字商品、轻会员、credits、后台、文档和双部署路径的 Web 产品。
当前稳定样板产品是 products/muse。products/01mvp**：01MVP 官网和复杂业务参考，不作为模板默认交付路径。
模板介绍看 模板页。这里主要写技术配置、开发流程和部署路径。
获取模板
购买 01MVP 高级会员。 模板授权面向高级会员开放，先在 会员页 完成购买。
联系 makerjackie 获取代码模板授权。 购买后联系 makerjackie 确认授权、交付方式和你的产品方向。
复制对应 prompt，让 AI 帮你上架网站。 在准备好数据库、Cloudflare 账号、域名、支付和对象存储等必要前置条件后，使用模板 prompt 让 AI 完成初始化、配置和部署。
只做 Web 的话，直接从 快速开始 进入。Mobile、Desktop 和小程序的准备项放在 实验室，需要做多端时再看。这些内容已经移动到 实验室。
开箱即用的能力
- 核心登录方式：邮箱密码、Google、GitHub、Magic Link、用户名已内置；微信登录作为可选模块提供配置开关
- 支付基础设施：数字商品、订单、ZPay 回调和会员权益已经接入；Stripe、微信支付、支付宝、PayPal 保留扩展 Provider 与接入指南
- 网站 AI 功能：基础文本对话、多模型路由、流式响应和 AI 工具执行，基于 AI SDK 封装
- AI 辅助开发：内置项目规则和初始化流程，让 AI 更容易按目录改代码、跑检查、处理部署
- 积分/额度系统：内置 credits 账本，对接支付后自动发放，可控制每个功能消耗额度
- 多语言 i18n：基于 Paraglide + TanStack Router，内置简中、繁中、英文、日文，并提供可新增语种的 OpenAI-compatible 增量翻译脚本
- 三层 UI 组件体系：shadcn 原语组件 + 跨应用共享业务组件 + 应用层自定义组件，边界清晰不越界
- 多端扩展参考：Mobile、Desktop 和小程序文档放在实验室，按客户端分别说明准备项和接入路径
- Monorepo + 24+ 共享包：Vite Plus + pnpm workspace 管理，每个包独立类型检查和测试，复用不耦合
- 双运行时部署：同一套 PostgreSQL + S3/R2 底座，可部署到 Zeabur Docker 或 Cloudflare Workers
配置指南
按任务找对应文档，先完成关键配置再开发业务功能。
快速开始
环境准备、数据库初始化、本地启动，10 分钟跑起来。
Vite Plus 工具链
了解 vp、vpr、vpx、monorepo 任务和传统命令替代关系。
技术选型说明
理解为什么选择 TanStack Start，以及 Hono、oRPC 什么时候才有必要引入。
环境变量
产品级 env、根目录共享配置和运行时配置的完整说明。
认证系统
核心登录方式、OAuth、会话、权限和微信登录扩展配置。
数据库
Drizzle ORM 模型定义、迁移和查询。
API 开发
路由定义、输入校验、错误处理和 OpenAPI 文档生成。
支付集成
默认支付路径、扩展 Provider、Webhook 处理和积分发放流程。
实现状态
查看 Muse 已接入的能力，以及需要按项目继续扩展的部分。
网站 AI 功能
面向用户的文本对话、多模型路由、AI 工具执行和安全边界。
AI 开发工作流
AGENTS、主题规范、Skills 和模板初始化流程。
文件存储
S3 对象存储配置，上传、预签名 URL 和 CDN 集成。
UI 与主题
主题预设切换、语义化 Token、Tailwind CSS v4 主题变量。
国际化
Paraglide 接入、翻译 key 管理和多语言路由。
部署上线
Zeabur + Cloudflare、Docker、Cloudflare Workers、环境变量和数据库迁移。
实验室
Mobile、Desktop 和小程序的准备项、参考实现和接入路径。
集成总览
支付、存储、邮件、短信、统计和 Apple 平台配置。
统计与分析
Cloudflare Web Analytics、GA4、百度统计、Umami 和应用事件追踪。
项目结构
项目采用 Vite Plus monorepo，核心目录如下：
products/muse/apps/web：Muse Web 应用，TanStack Start + TanStack Router，页面、文档和 Hono 入口都在这里products/muse/packages/*：Muse 产品内复用能力，包含 API、auth、db、i18n、payment、credits 和产品 configproducts/01mvp：01MVP 官网业务代码，可作为复杂业务参考；需要复用时按场景迁移packages/*：跨产品共享包，只放多个产品都能复用的基础能力，例如 UI 原语、邮件、日志、SEO、存储和通用工具packages/ui：纯 shadcn/ui 原语，只通过 CLI 更新，业务组件不要放进这里
这个结构适合把多个 Web coding 项目放在同一个仓库里：每个产品都有自己的 apps 和产品包，根目录共享工具、代码规范、Agent Skills 和跨产品基础包。这样新产品不用重复复制轮子，产品代码之间也不会互相污染。
技术栈
| 类别 | 技术 | 说明 |
|---|---|---|
| 框架 | TanStack Start | React 全栈框架，Vite 构建，SSR + 文件路由 |
| 语言 | TypeScript 5.9 | 严格模式全开，编译期类型检查 |
| 数据库 | PostgreSQL + Drizzle ORM | TypeScript schema、类型安全查询和迁移脚本统一管理 |
| 认证 | Better Auth | 支持邮箱、手机、OAuth、Magic Link 等多种登录方式 |
| 支付 | 数字商品 + ZPay；Stripe / 微信支付 / 支付宝 / PayPal 扩展 Provider | ZPay 是默认自动履约路径，其他 Provider 按项目需要扩展 |
| AI | AI SDK | 多模型文本对话、流式响应和 AI 工具执行 |
| UI | Tailwind CSS v4 + shadcn/ui | 语义化 Token + 主题预设，支持暗色模式 |
| API | Hono + oRPC | Hono 挂载到 TanStack Start 的 /api 路由，oRPC 负责类型安全调用 |
| i18n | Paraglide | 翻译文件结构化管理，内置增量 AI 翻译，和 TanStack Router 路由配合 |
| Monorepo | Vite Plus + pnpm workspace | 工作区依赖管理、任务运行、测试和 hooks |
| 文档 | Fumadocs | 基于 MDX，使用 TanStack 适配，支持搜索和多语言 |
| 部署 | Zeabur Docker + Cloudflare Workers | 同一套代码支持 Docker 运行时和 Cloudflare Workers 运行时，默认生产路径是 Zeabur Docker |
| 代码质量 | Vite Plus Check | 统一格式化、lint 和类型检查 |
部署策略
这套部署方案让数据库和文件存储保持一致，网页运行时按用户位置和成本选择。
| 层级 | 默认选择 | 原因 |
|---|---|---|
| 数据库 | PostgreSQL | 长期运营、复杂查询、迁移、备份和跨平台托管更成熟 |
| 对象存储 | Cloudflare R2（S3 兼容） | 默认便宜、配置简单；以后可迁移到 AWS S3、腾讯云 COS、MinIO 等 S3 兼容服务 |
| 国内生产部署 | Zeabur Docker 或自有服务器 Docker | 适合主要用户在中国大陆、需要更可控的访问速度和备案路径 |
| 海外生产部署 | Cloudflare Workers + PostgreSQL | 适合主要用户在海外、希望低成本使用 Cloudflare 边缘运行时 |
你不需要维护两套产品代码。业务逻辑、数据库 schema、支付、账号、文件存储和后台管理保持一致，部署时只选择 Docker 运行时或 Cloudflare Workers 运行时。
D1 可以支撑轻量网站和 Cloudflare-first 项目，但 01MVP Start 默认不使用 D1 作为长期数据库。模板优先保证后续商业运营不需要再从 D1 迁移到 PostgreSQL。
选择网站风格
模板使用 Muse 当前视觉系统和 Tailwind CSS v4 主题变量。自定义品牌风格时，优先改 products/muse/apps/web/src/shared/styles/theme.css 里的语义化 token，不要在业务组件里散落一次性颜色。
推荐阅读路径
第一次接手模板
跑起来：快速开始 -- 环境准备、数据库初始化、本地启动
看架构：项目架构 -- monorepo 结构、包边界、配置体系
上线：部署指南 -- Zeabur + Cloudflare、Docker、Cloudflare Workers、环境变量和域名配置
正在做功能改造
直接找对应指南即可，不需要先理解整个架构：
| 要做的事 | 对应文档 |
|---|---|
| 登录、OAuth、权限 | 认证系统 |
| Vite Plus、vpr、workspace 命令 | Vite Plus 工具链 |
| 新增数据表和迁移 | 数据库 |
| AI 文本对话 | 网站 AI 功能 |
| AGENTS、Skills、AI 协作 | AI 开发工作流 |
| 接口和 OpenAPI | API 开发 |
| Web、Mobile、Desktop、小程序 | 实验室 |
| 页面和主题 | UI 与主题 |
| 国际化 | 国际化接入 |
| 支付和积分 | 支付与积分 |
| 文件上传和存储 | 存储与文件 |
| 权限与风控 | 权限与风控 |
文档分层说明
文档按用途分成几类，根据你当前要做的事选择：
| 分类 | 定位 |
|---|---|
| 介绍 | 模板能力概览和推荐阅读路径 |
| 开发工作流 | 本地环境、编码规范、测试、CI/CD 和常见开发问题 |
| AI 开发工作流 | AGENTS、主题规范、Skills、模板初始化和仓库维护方式 |
| 基础配置 | 项目架构、环境变量、主题、国际化、SEO——让模板变成你的产品 |
| 核心 | 数据库、认证、API、网站 AI 功能、文档系统——项目运行的技术底座 |
| 实验室 | Mobile、Desktop、小程序等客户端形态的准备项和参考实现 |
| 部署与运维 | Zeabur + Cloudflare、Docker、Cloudflare Workers、日志和健康检查 |
| 集成 | 支付、存储、邮件、短信、Apple 平台、统计与分析等外部服务，按需接入 |
| 安全 | Cloudflare 防护、限流、人机验证、上传边界、密钥保护和权限模型 |
| 进阶能力 | Feature flags、ASR 等有明确业务需要后再接入的能力 |
需要帮助？
文档有任何不清楚的地方，可以直接在页面底部反馈，我们持续改进。
想和其他创造者交流？
这篇文档有问题？