https://github.com/ethanz-code/monorepo-vue-starter
现代化 Monorepo 架构的 Vue 起始项目，更新于 2025-06-24。
https://github.com/ethanz-code/monorepo-vue-starter
Last synced: 9 months ago
JSON representation
现代化 Monorepo 架构的 Vue 起始项目，更新于 2025-06-24。
- Host: GitHub
- URL: https://github.com/ethanz-code/monorepo-vue-starter
- Owner: ethanz-code
- Created: 2025-06-24T11:08:35.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-06-24T11:20:41.000Z (9 months ago)
- Last Synced: 2025-06-24T12:37:24.518Z (9 months ago)
- Language: TypeScript
- Size: 72.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# monorepo-vue-starter
现代化 Monorepo 架构的 Vue 起始项目，基于 Vite、Vue 3、TypeScript，内置 TailwindCSS 原子化方案，采用 pnpm 作为包管理工具，适合中大型团队高效开发与协作。
## 项目亮点
- **Monorepo 架构**：基于 pnpm workspace，支持多包统一管理，便于模块复用与团队协作。
- **Vue 3 + Vite**：极速开发体验，支持最新 Composition API。
- **TypeScript 全量类型支持**：集成 vue-tsc，类型安全无忧。
- **TailwindCSS 原子化 CSS**：极致灵活的样式方案，支持自定义扩展。
- **严格代码规范**：集成 ESLint、Prettier、Commitlint、Husky，保障团队代码质量。
- **现代化开发体验**：支持 VSCode + Volar，类型推断与高亮无缝体验。
## 目录结构
```text
monorepo-vue-starter/
├── packages/ # Monorepo 子包（可扩展自定义工具包）
├── src/ # 主应用源码
│ ├── assets/ # 静态资源与全局样式（已引入 TailwindCSS）
│ ├── components/ # 通用组件
│ ├── views/ # 页面视图
│ ├── stores/ # 状态管理
│ └── router/ # 路由配置
├── public/ # 公共资源
├── package.json # 根包配置，依赖与脚本
├── pnpm-workspace.yaml # Monorepo 配置
├── vite.config.ts # Vite 配置，已集成 TailwindCSS
└── ... # 其他配置文件
```
## 快速开始
### 环境要求
- Node.js 18 及以上
- [pnpm](https://pnpm.io/) 10 及以上
### 安装依赖
```sh
pnpm install
```
### 代码检查与格式化
```sh
pnpm run lint # 代码规范检查
pnpm run format # 代码格式化
```
### 类型检查
```sh
pnpm run type-check
```
## 推荐开发工具
### 推荐开发工具
- [VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar)（请禁用 Vetur）
## 依赖说明
- **主依赖**：
- `vue`、`vue-router`、`@vueuse/core`
- **开发依赖**：
- `vite`、`@vitejs/plugin-vue`、`tailwindcss`、`eslint`、`prettier`、`husky`、`vue-tsc`、`commitlint`、`lint-staged`、`onchange`、`typescript` 等
- **工具包依赖**（如有）：
- `@ethan-utils/axios`、`@ethan-utils/pinia` 等
## 代码规范与提交
- 采用 ESLint + Prettier 统一代码风格
- 提交前自动 lint & format
- 使用 Commitlint 规范提交信息
- Husky 钩子自动化流程
## 进阶用法
- 可在 `packages/` 目录下扩展自定义工具包
- TailwindCSS 配置可在根目录自定义
- 支持多环境配置与环境变量注入
## 参考文档
- [Vite 官方文档](https://vitejs.dev/)
- [Vue 3 官方文档](https://cn.vuejs.org/)
- [TailwindCSS 官方文档](https://tailwindcss.com/)
- [pnpm 官方文档](https://pnpm.io/)
---
如需二次开发或团队协作建议，欢迎补充需求！