01MVP 模板指南
模板指南 -- 已内置的账号、支付、AI、国际化和部署能力，帮你专注产品本身。
01MVP 是一套面向独立开发者和小团队的全栈项目代码模板。它内置了账号、支付、AI、i18n 等基础模块，也保留了常见扩展渠道的接入文档，帮助你快速启动项目。
代码模板正在开发中，当前为文档预览版，非最终成果
代码模板后续会面向付费会员开放，敬请期待。
想先判断这套模板是否适合你的产品，可以先看 代码模板介绍页。获取入口会放在 会员页，正式开放前也会在那里登记意向。
开箱即用的能力
- 核心登录方式：邮箱密码、手机号、Google、GitHub、Magic Link、用户名已内置；微信登录提供预集成插件和配置指南
- 支付基础设施：Stripe 和 Waffo 是默认可切换路径；微信支付、支付宝、PayPal 提供 Provider 和扩展接入指南
- AI 能力集成：对话、图片生成、视频生成、多模型路由，基于 Vercel AI SDK 封装，接新模型一行代码
- 积分/额度系统：内置 credits 账本，对接支付后自动发放，可控制每个功能消耗额度
- 中英双语 i18n：基于 next-intl，翻译文件结构清晰，新增语言只需加一个目录
- 三层 UI 组件体系：shadcn 原语组件 + 跨应用共享业务组件 + 应用层自定义组件，边界清晰不越界
- Monorepo + 24+ 共享包：pnpm workspace + Turborepo 管理，每个包独立类型检查和测试，复用不耦合
- Zeabur 优先部署：通过 Zeabur Agent Skills 部署，Cloudflare 负责域名代理、HTTPS 和 WAF
配置指南
按任务找对应文档，先完成关键配置再开发业务功能。
快速开始
环境准备、数据库初始化、本地启动，10 分钟跑起来。
环境变量
项目配置体系，从 .env.local 到运行时配置的完整说明。
认证系统
核心登录方式、OAuth、会话、权限和微信登录扩展配置。
数据库
Drizzle ORM 模型定义、迁移和查询。
API 开发
路由定义、输入校验、错误处理和 OpenAPI 文档生成。
支付集成
默认支付路径、扩展 Provider、Webhook 处理和积分发放流程。
AI 核心能力
运行时 AI 能力、项目说明书和预置 Agent Skills。
文件存储
S3 对象存储配置，上传、预签名 URL 和 CDN 集成。
UI 与主题
主题预设切换、语义化 Token、Tailwind CSS v4 主题变量。
国际化
next-intl 接入、翻译 key 管理和多语言路由。
部署上线
Zeabur 部署流程、环境变量配置、数据库迁移和 Cloudflare 域名代理。
项目结构
项目采用 pnpm monorepo，核心目录如下：
apps/01mvp-web：主应用，Next.js App Router，业务代码都在这里packages/*：共享包，按领域拆分（auth、payment、ai 等），workspace:*引用，src/index.ts导出packages/ui：纯 shadcn/ui 原语，只通过 CLI 更新，手动修改禁止packages/ui-shared：跨应用共用业务组件（Logo、UserAvatar、密码输入框等）
技术栈
| 类别 | 技术 | 说明 |
|---|---|---|
| 框架 | Next.js 16 | React 全栈框架，Turbopack 构建，SSR + API 路由 + 文件路由 |
| 语言 | TypeScript 5.9 | 严格模式全开，编译期类型检查 |
| 数据库 | PostgreSQL + Drizzle ORM | TypeScript schema、类型安全查询和迁移脚本统一管理 |
| 认证 | Better Auth | 支持邮箱、手机、OAuth、Magic Link 等多种登录方式 |
| 支付 | Stripe / Waffo 默认切换；微信支付 / 支付宝 / PayPal 扩展 Provider | 国际和国内支付的基础设施与扩展路径 |
| AI | Vercel AI SDK | 多模型对话、图片/视频生成、流式响应 |
| UI | Tailwind CSS v4 + shadcn/ui | 语义化 Token + 主题预设，支持暗色模式 |
| i18n | next-intl | 中英双语，翻译文件结构化管理 |
| Monorepo | pnpm + Turborepo | 工作区依赖管理 + 构建缓存加速 |
| 文档 | Fumadocs | 基于 MDX，支持搜索、多语言 |
| 部署 | Zeabur + Cloudflare | Zeabur 跑容器，Cloudflare 负责 DNS/CDN/WAF |
| 代码质量 | Biome | 统一 linting 和格式化 |
选择网站风格
模板内置 4 个主题预设，切换只改 CSS 变量，不改业务代码。如果你想自定义品牌风格，参考 UI 与主题指南。
01MVP
硬核极简，外层强边框，内部灰色分割。
Linear
更柔和的风格，微冷色调加圆角。
Blueprint
带一点工程蓝的精致风格，适合仪表盘和工具界面。
Claude
温和的阅读感，适合教程和长文内容。
推荐阅读路径
第一次接手模板
正在做功能改造
直接找对应指南即可，不需要先理解整个架构：
| 要做的事 | 对应文档 |
|---|---|
| 登录、OAuth、权限 | 认证系统 |
| 新增数据表和迁移 | 数据库 |
| AI 对话、生成和 Skills | AI 核心能力 |
| 接口和 OpenAPI | API 开发 |
| 页面和主题 | UI 与主题 |
| 国际化 | 国际化接入 |
| 支付和积分 | 支付与积分 |
| 文件上传和存储 | 存储与文件 |
| 权限与风控 | 权限与风控 |
文档分层说明
文档分六层，根据你当前需要的深度选择：
| 分类 | 定位 |
|---|---|
| 快速开始 | 模板介绍和环境搭建，10 分钟跑起来 |
| 基础配置 | 项目架构、环境变量、主题、国际化、SEO——让模板变成你的产品 |
| 核心 | 数据库、认证、AI、编码规范——项目运行的技术底座 |
| 扩展 | 支付、存储、邮件、短信、API、分析等可选模块，按需接入 |
| 进阶 | 安全风控、缓存、限流、日志——有实际用户后再接 |
| 部署与运维 | Zeabur 部署、Cloudflare 域名代理、测试、CI/CD、排障 |
需要帮助？
文档有任何不清楚的地方，可以直接在页面底部反馈，我们持续改进。