01MVP Starter Kit

01MVP 是一套面向独立开发者和小团队的全栈项目底座。账号、支付、AI、数据库、i18n、部署这些高频模块已经接好，你不需要从零搭建，直接在上面改。

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

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

开箱即用的能力

7+ 登录方式：邮箱密码、手机号、Google、GitHub、微信、Magic Link（免密码邮箱链接登录）、用户名，接入 Better Auth 一次搞定
5 个支付渠道：Stripe、微信支付、支付宝、PayPal、Waffo，统一调用接口，切换渠道只需改配置
AI 能力集成：对话、图片生成、视频生成、多模型路由，基于 Vercel AI SDK 封装，接新模型一行代码
积分/额度系统：内置 credits 账本，对接支付后自动发放，可控制每个功能消耗额度
中英双语 i18n：基于 next-intl，翻译文件结构清晰，新增语言只需加一个目录
三层 UI 组件体系：shadcn 原语组件 + 跨应用共享业务组件 + 应用层自定义组件，边界清晰不越界
Monorepo + 24+ 共享包：pnpm workspace + Turborepo 管理，每个包独立类型检查和测试，复用不耦合
Vercel 优先部署：push 即部署，预览环境自动生成，CI/CD 已接好

配置指南

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

快速开始

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

环境变量

项目配置体系，从 .env.local 到运行时配置的完整说明。

认证系统

7+ 登录方式接入，OAuth、会话、权限的基本配置。

数据库

Prisma ORM（对象关系映射，帮你自动写 SQL 的工具）模型定义、迁移和查询。

API 开发

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

支付集成

5 个支付渠道接入、Webhook 处理和积分发放流程。

AI 功能

多模型对话、图片/视频生成接入和额度控制。

文件存储

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

UI 与主题

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

国际化

next-intl 接入、翻译 key 管理和多语言路由。

部署上线

Vercel 部署流程、环境变量配置和域名绑定。

项目结构

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

turbo.json

pnpm-workspace.yaml

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 + Prisma ORM	ORM 自动生成类型安全的查询代码，迁移脚本统一管理
认证	Better Auth	支持邮箱、手机、OAuth、Magic Link 等多种登录方式
支付	Stripe / 微信支付 / 支付宝 / PayPal / Waffo	国际和国内支付统一接口
AI	Vercel AI SDK	多模型对话、图片/视频生成、流式响应
UI	Tailwind CSS v4 + shadcn/ui	语义化 Token + 主题预设，支持暗色模式
i18n	next-intl	中英双语，翻译文件结构化管理
Monorepo	pnpm + Turborepo	工作区依赖管理 + 构建缓存加速
文档	Fumadocs	基于 MDX，支持搜索、多语言
部署	Vercel	push 即部署，预览环境自动创建
代码质量	Biome	统一 linting 和格式化

选择网站风格

模板内置 4 个主题预设，切换只改 CSS 变量，不改业务代码。如果你想自定义品牌风格，参考 UI 与主题指南。

01MVP

硬核极简，外层强边框，内部灰色分割。

Linear

更柔和的产品界面，轻微冷色和圆角。

Claude

温和的阅读感，适合教程和长文内容。

Vercel

黑白灰、细边框、低装饰，适合产品官网和文档。

要做的事	对应文档
登录、OAuth、权限	认证系统
新增数据表和迁移	数据库
接口和 OpenAPI	API 开发
页面和主题	UI 与主题
国际化	国际化接入
支付和积分	支付与积分
文件上传和存储	存储与文件
权限与风控	权限与风控

文档分层说明

文档分五层，根据你当前需要的深度选择：

层级	定位
开始使用	跑起来 + 知道下一步读什么
核心概念	为什么这样组织，理解边界和约束
功能指南	按任务组织，解决具体问题的主入口
上线与维护	测试、发布、CI/CD、排障
参考手册	Workspace 包、编码规范、扩展点

需要帮助？

常见问题先看开发 FAQ
代码规范和提交约定看编码规范
需要更底层的实现细节，进入 Workspace 包参考

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

01MVP 代码模板指南