快速开始

环境要求

Node.js 24
Git
Vite Plus CLI（vp、vpx、vpr）

本地开发使用 Wrangler 管理的 SQLite 数据库，不需要安装 PostgreSQL。

安装与初始化数据库

git clone <your-repository-url>
cd 01mvp-start
vp install
vpr @01mvp/product#db:migrate

db:migrate 只操作本地 D1 数据。首次创建的账号会自动成为 super_admin，不再依赖开发数据库 seed。

配置本地环境

在 products/01mvp/packages/config/.env.local 中放产品专属变量：

BETTER_AUTH_SECRET=replace-with-a-long-random-secret
VITE_WEB_URL=http://localhost:7001
VITE_SERVER_URL=http://localhost:7001/api
AUTH_COOKIE_PREFIX=your_product

AI 模型、短信、统计等跨产品默认值可以放在 packages/config/.env.local。产品配置优先于共享配置。

Cloudflare Worker 通过 DB binding 直接访问 D1，本地 Wrangler 会自动提供对应 binding，所以本地启动不需要数据库连接串。只有把 Node/Docker 部署连接到远端 D1 时，才需要服务端的 D1_PROXY_URL 和 D1_PROXY_TOKEN。

启动与检查

vpr @01mvp/product#dev

打开 http://localhost:7001，创建第一个账号，然后检查公开页、登录、后台和你准备保留的业务功能。

改动完成后运行：

vpr @01mvp/product#lint
vpr @01mvp/product#type-check
vpr @01mvp/product#test
vpr @01mvp/product#build

涉及登录、数据库或关键购买流程时，再运行：

vpr @01mvp/product#test:e2e

E2E 会创建独立的本地 D1 数据目录、应用 migration 并启动 Wrangler，不会连接生产数据库。

改造成你的网站

让 AI 使用仓库里的 01mvp-template-initializer Skill，并直接描述产品，例如：

基于 01MVP 创建一个中文数字产品网站。保留账号、数字商品和后台，删除 AI、积分、付费文档、邀请返利和社区。品牌叫 Example，部署到 Cloudflare。

AI 会读取能力清单和当前依赖图，先给出保留、删除、暂缓的判断，再完成品牌替换、完整功能裁剪、残留扫描和验证。你只需要明确产品目标，不必自己维护一份容易过期的文件删除列表。

下一步阅读数据库和部署方式。