# Vue3 Monorepo

**Repository Path**: T0525/MonorepoDemo

## Basic Information

- **Project Name**: Vue3 Monorepo
- **Description**: 基于 Monorepo 架构的 Vue3 前端项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-19
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vue3 Monorepo 项目

这是一个基于 Vue3 + Vite + pnpm + Turbo 的现代化 Monorepo 项目。

## 🚀 技术栈

- **框架**: Vue 3.4+
- **构建工具**: Vite 5.3+
- **包管理器**: pnpm 10.6+
- **Monorepo 工具**: Turbo + Lerna
- **UI 框架**: Element Plus
- **CSS 框架**: Tailwind CSS
- **状态管理**: Pinia
- **路由**: Vue Router 4

## 📁 项目结构

```
MonorepoDemo/
├── apps/                    # 应用目录
│   ├── admin/              # 管理后台
│   └── web/                # 前台网站
├── packages/               # 共享包目录
│   ├── assets/            # 静态资源
│   ├── components/        # 公共组件
│   ├── composables/       # 组合式函数
│   ├── directives/        # 自定义指令
│   ├── styles/            # 样式文件
│   ├── tailwind/          # Tailwind 配置
│   └── utils/             # 工具函数
├── pnpm-workspace.yaml    # pnpm 工作空间配置
├── turbo.json            # Turbo 配置
└── package.json          # 根包配置
```

## 🛠️ 开发环境要求

- Node.js >= 18.0.0
- pnpm >= 8.0.0

## 📦 安装依赖

```bash
# 安装所有依赖
pnpm install

# 或者使用 npm
npm install
```

## 🚀 开发命令

### 启动开发服务器

```bash
# 启动所有应用
pnpm dev:all

# 启动管理后台
pnpm dev:admin

# 启动前台网站
pnpm dev:web
```

### 构建项目

```bash
# 构建所有项目
pnpm build:all

# 构建管理后台
pnpm build:admin

# 构建前台网站
pnpm build:web

# 构建所有包
pnpm build:packages
```

### 代码质量

```bash
# 代码检查
pnpm lint

# 自动修复
pnpm lint:fix

# 类型检查
pnpm type-check
```

### 清理

```bash
# 清理构建文件
pnpm clean

# 清理所有文件（包括 node_modules）
pnpm clean:all
```

### 部署

```bash
# 部署到测试环境
pnpm deploy:test:admin
pnpm deploy:test:web

# 部署到生产环境
pnpm deploy:admin
pnpm deploy:web
```

## 📋 包管理

### 添加新依赖

```bash
# 添加到根目录
pnpm add <package-name>

# 添加到特定应用
pnpm add <package-name> --filter admin
pnpm add <package-name> --filter web

# 添加到特定包
pnpm add <package-name> --filter @mo/components
```

### 添加开发依赖

```bash
# 添加到根目录
pnpm add -D <package-name>

# 添加到特定应用
pnpm add -D <package-name> --filter admin
```

## 🔧 配置说明

### pnpm-workspace.yaml

使用 catalog 功能统一管理依赖版本，避免版本冲突。

### turbo.json

配置了构建缓存和任务依赖关系，提高构建效率。

### .npmrc

优化了 pnpm 的安装和缓存配置。

## 📝 开发规范

1. **包命名**: 共享包使用 `@mo/` 前缀
2. **依赖管理**: 使用 catalog 统一管理版本
3. **构建顺序**: 包优先构建，应用后构建
4. **缓存策略**: 合理使用 Turbo 缓存