手动开始

欢迎来到 MvpFast 👏

MvpFast 是一套基于 Next.js 15 的全栈 SaaS 模板，集成了登录鉴权、微信支付、数据库、AI 对话、国际化等能力，帮助你快速构建并上线 MVP 产品。

启动项目

1. 克隆仓库

购买后会邀请进入 GitHub 仓库，通过以下命令拉取代码：

git clone https://github.com/mvpfast/xxxxx.git
cd mvpfast
pnpm install
git remote remove origin

要求 Node.js >= 20.0.0，推荐使用 pnpm 作为包管理器。

2. 配置环境变量

复制 .env.example 为 .env，填写必要配置：

cp .env.example .env

最小启动配置（只需这两项即可运行）：

# 数据库（MongoDB Atlas 免费创建）
DATABASE_URL="mongodb+srv://user:pass@cluster.mongodb.net/mydb"

# Auth 密钥（终端执行 openssl rand -base64 32 生成）
AUTH_SECRET="你的密钥"

其他配置（微信支付、短信、邮件、AI 等）按需开启，详见 .env.example 中的注释。

开发环境下无需配置短信/邮件服务，可使用万能验证码 000000 登录。

3. 初始化数据库

npx prisma db push

4. 创建管理员

npx tsx scripts/create-admin.ts admin@example.com

5. 启动开发服务器

pnpm dev

打开 http://localhost:3000 即可看到你的网站。

项目结构

src/
├── app/
│   ├── (fumadocs)/        # 文档和博客（独立布局）
│   ├── (main)/            # 主应用
│   │   ├── [local]/       # 国际化路由 (/zh, /en)
│   │   │   ├── auth/      # 登录注册
│   │   │   ├── dashboard/ # 后台管理（RBAC 保护）
│   │   │   └── pay/       # 支付页面
│   │   └── api/           # API 路由
│   │       ├── admin/     # 管理员接口
│   │       ├── user/      # 用户接口
│   │       └── wx/        # 微信（支付 + 登录）
├── components/            # React 组件
├── models/                # 数据库操作函数
├── lib/                   # 工具库（鉴权、支付、配置等）
├── i18n/messages/         # 国际化翻译文件
├── store/                 # Redux 状态管理
├── config.ts              # 购买模式、商品配置
├── auth.ts                # NextAuth 认证配置
└── middleware.ts           # 路由中间件（i18n + RBAC）

prisma/schema.prisma       # 数据库模型定义
content/                   # MDX 文档和博客内容

核心配置文件

文件	作用
`src/config.ts`	购买模式（直接购买 / 积分模式）、商品定义
`src/auth.ts`	登录方式配置（密码、验证码、微信）
`src/lib/rbac.ts`	角色权限定义（admin / user）
`src/i18n/messages/*.json`	国际化文本（含导航、首页、价格等）
`src/app/(main)/globals.css`	主题色配置（DaisyUI 变量）
`.env`	环境变量（数据库、支付、短信、AI 等）

接下来请按照左侧文档目录，逐步配置数据库、支付、登录等功能模块。

On this page