---
description:
globs:
alwaysApply: false
---
# Vben 项目快速启动

## 环境要求

- Node.js 20.15.0 及以上版本 (推荐使用 `fnm` 或 `nvm` 进行版本管理)
- Git 任意版本

检查命令:
`node -v`
`git -v`

## 启动项目

### 1. 获取源码
```sh
# 克隆 GitHub 仓库
git clone https://github.com/vbenjs/vue-vben-admin.git

# 或者克隆 Gitee 仓库 (可能不是最新的)
git clone https://gitee.com/annsion/vue-vben-admin.git
```
**注意**: 存放代码的目录及所有父级目录不能存在中文、韩文、日文以及空格。

### 2. 安装依赖
进入项目根目录 (例如 `vue-vben-admin`) 后执行:
```sh
# 启用项目指定的 pnpm 版本
corepack enable

# 安装依赖 (项目只支持 pnpm)
pnpm install
```

### 3. 运行项目
```sh
# 启动项目 (会提示选择子项目)
pnpm dev
```
之后，可以选择要运行的子项目，例如 `@vben/web-ele`。
访问 `http://localhost:5555` 查看。

#### 直接运行指定项目
```sh
pnpm run dev:antd
pnpm run dev:ele
pnpm run dev:naive
pnpm run dev:docs
pnpm run dev:play
```

相关文件:
- 项目依赖管理: [pnpm-workspace.yaml](mdc:pnpm-workspace.yaml)
- Turbo Repo 配置: [turbo.json](mdc:turbo.json)
- 包管理: [package.json](mdc:package.json)
