01MVP 模板指南

01MVP 是一套面向独立开发者和小团队的全栈项目代码模板。它以内置账号、支付、AI、i18n 和部署流程的 Web 模板为主线，同时规划了 Mobile、Desktop 和小程序等应用端模板，帮助你从 Web-first 的方式启动产品。

代码模板正在开发中，当前为文档预览版，非最终成果

代码模板后续会面向付费会员开放，敬请期待。

想先判断这套模板是否适合你的产品，可以先看代码模板介绍页。获取入口会放在会员页，正式开放前也会在那里登记意向。

如果你只做 Web，直接从快速开始进入。本页不展开 Mobile、Desktop 或小程序的账号清单；这些准备项只放在对应应用端文档里。

开箱即用的能力

核心登录方式：邮箱密码、手机号、Google、GitHub、Magic Link、用户名已内置；微信登录提供预集成插件和配置指南
支付基础设施：数字商品、订单、ZPAY 回调和会员权益已经接入；Stripe、微信支付、支付宝、PayPal 保留扩展接入指南
网站 AI 功能：对话、图片生成、视频生成、多模型路由，基于 AI SDK 封装，接新模型一行代码
AI 开发工作流：AGENTS、主题规范、repo-local Skills 和模板初始化流程已经内置，AI 编码工具能按仓库边界工作
积分/额度系统：内置 credits 账本，对接支付后自动发放，可控制每个功能消耗额度
多语言 i18n：基于 Paraglide + TanStack Router，内置简中、繁中、英文、日文，并提供可新增语种的 OpenAI-compatible 增量翻译脚本
三层 UI 组件体系：shadcn 原语组件 + 跨应用共享业务组件 + 应用层自定义组件，边界清晰不越界
应用端模板路线：Web 为 Stable 主模板；Mobile、Desktop 为 Beta；小程序处于 Planned 阶段，后续按成熟度持续补齐
Monorepo + 24+ 共享包：Vite Plus + pnpm workspace 管理，每个包独立类型检查和测试，复用不耦合
双部署路径：默认使用 Zeabur + Cloudflare 上线，同时保留 Cloudflare Workers 可选部署说明

配置指南

按任务找对应文档，先完成关键配置再开发业务功能。

快速开始

环境准备、数据库初始化、本地启动，10 分钟跑起来。

Vite Plus 工具链

了解 vp、vpr、vpx、monorepo 任务和传统命令替代关系。

环境变量

产品级 env、共享 env 兜底和运行时配置的完整说明。

认证系统

核心登录方式、OAuth、会话、权限和微信登录扩展配置。

数据库

Drizzle ORM 模型定义、迁移和查询。

API 开发

路由定义、输入校验、错误处理和 OpenAPI 文档生成。

支付集成

默认支付路径、扩展 Provider、Webhook 处理和积分发放流程。

网站 AI 功能

面向用户的对话、生成、多模型路由、额度扣费和安全边界。

AI 开发工作流

AGENTS、主题规范、Skills 和模板初始化流程。

文件存储

S3 对象存储配置，上传、预签名 URL 和 CDN 集成。

UI 与主题

主题预设切换、语义化 Token、Tailwind CSS v4 主题变量。

国际化

Paraglide 接入、翻译 key 管理和多语言路由。

部署上线

Zeabur + Cloudflare、Docker、Cloudflare Workers、环境变量和数据库迁移。

应用端模板

Web、Mobile、Desktop 和小程序的定位、成熟度和推荐使用顺序。

集成总览

支付、存储、邮件、短信、统计和 Apple 平台配置。

上线统计

用 Cloudflare Web Analytics 做早期访问统计和真实性能观察。

项目结构

项目采用 Vite Plus monorepo，核心目录如下：

pnpm-workspace.yaml

vite.config.ts

products/01mvp/apps/web：Stable 主应用，TanStack Start + TanStack Router，页面、文档和 Hono 入口都在这里
products/01mvp/apps/mobile：Beta 移动端模板，Expo App，复用 Web/API 后端
products/01mvp/apps/desktop：Beta 桌面端模板，Tauri App，复用 Web/API 后端
products/01mvp/packages/*：01MVP 产品内复用能力，包含 API、auth、db、i18n、payment、credits 和产品 config
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	国内支付、数字商品和后续会员权益的基础设施
AI	AI SDK	多模型对话、图片/视频生成、流式响应
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；Cloudflare Workers 可选	Zeabur 是默认生产部署路径，Cloudflare 负责域名代理、HTTPS、WAF 和基础统计
代码质量	Vite Plus Check	统一格式化、lint 和类型检查

要做的事	对应文档
登录、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 功能、文档系统——项目运行的技术底座
应用端模板	Web、Mobile、Desktop、小程序等客户端形态，按成熟度逐步交付
部署与运维	Zeabur + Cloudflare、Docker、Cloudflare Workers、上线统计、日志和健康检查
集成	支付、存储、邮件、短信、Apple 平台、应用内数据统计等外部服务，按需接入
安全	Cloudflare 防护、限流、人机验证、上传边界、密钥保护和权限模型
进阶能力	Feature flags、ASR 等有明确业务需要后再接入的能力

需要帮助？

常见问题先看开发 FAQ
代码规范和提交约定看编码规范

文档有任何不清楚的地方，可以直接在页面底部反馈，我们持续改进。