快速开始

5 分钟搭建本地开发环境

前置要求

Node.js 22+: 下载地址
pnpm 9.12.3+: npm install -g pnpm
PostgreSQL 数据库: 推荐 Neon 或本地安装

快速启动

# 1. 克隆项目
git clone https://github.com/01mvp/mono.git
cd mono

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp apps/mono-web/.env.example apps/mono-web/.env.local
# 编辑 apps/mono-web/.env.local，设置必填项

必填环境变量

# 数据库连接
DATABASE_URL="postgresql://username:password@host:port/database"

# Better Auth 密钥（生成方式: openssl rand -base64 32）
BETTER_AUTH_SECRET="your-random-secret-key"

# 站点地址
NEXT_PUBLIC_SITE_URL="http://localhost:3000"

# 4. 初始化数据库
pnpm db:generate  # 生成 Prisma 客户端
pnpm db:push      # 推送数据库结构（开发环境）

# 5. 启动开发服务器
pnpm dev

访问 http://localhost:3000 查看网站。

开发工具

工具	地址	说明
网站首页	http://localhost:3000	本地开发站点
Prisma Studio	`pnpm db:studio`	数据库可视化管理

常见问题

`pnpm: command not found`

npm install -g pnpm

数据库连接失败

检查 DATABASE_URL 格式是否正确
确认数据库服务正在运行
验证用户名和密码

端口 3000 被占用

pnpm dev -- -p 3001

TypeScript 类型错误

pnpm db:generate      # 重新生成 Prisma 客户端
pnpm type-check       # 检查类型
rm -rf .next          # 清除缓存后重试

快速开始

前置要求

快速启动

必填环境变量

开发工具

常见问题

`pnpm: command not found`

数据库连接失败

端口 3000 被占用

TypeScript 类型错误

下一步

On this page