如需 标准版本前端【单用户独立版本】，请访问：madong-single / madong-aura（管理后台）、web-nuxt（门户）。
Madong-Saas 前端大仓（Monorepo），是基于 Vben Admin（Vue 3 + Vite + TypeScript）的多租户 SaaS 前端工程，与后端 madong-admin-saas 配套使用。
- 采用 pnpm + Turbo 的 Monorepo 架构，应用与公共包分仓管理；
- 内置多端应用：
admin（租户管理后台）、platform（平台 / 租户管理）、install（安装向导）、backend-mock（接口 Mock）； - 可复用标准版本前端，但因服务接口存在差异，需针对性调整部分接口。
前后端分离部署，前端大仓需单独克隆到
madong/template目录。
本项目为 前端大仓（核心），配套后端、门户与工具仓库如下（默认从 GitHub 拉取，网络受限时可改用 Gitee / GitCode 镜像）：
完整版本发布与下载见下载中心。
- Node.js ^20.19.0 || ^22.18.0 || ^24.0.0
- pnpm >= 10.0.0
- Git
按标准目录布局，将本仓库克隆到 madong/template，后端克隆到同级目录 madong/backend。
# 1. 克隆前端大仓
git clone https://github.com/madong-code/madong-mono.git madong/template
cd madong/template
# 2. 安装依赖
pnpm install
# 3. 启动开发服务（以租户管理后台 admin 为例）
pnpm -F @madong/admin dev
# 启动平台管理 platform
pnpm -F @madong/platform dev
# 启动安装向导 install
pnpm -F @madong/install dev
# 4. 构建
pnpm build
web-nuxt门户站点为独立 Nuxt SSR 工程，与多租户版共用，请参考其仓库说明单独部署。
madong/template/ # 前端大仓（本仓库）
├── apps/ # 应用
│ ├── admin/ # 租户管理后台（@madong/admin）
│ ├── platform/ # 平台 / 租户管理（@madong/platform）
│ ├── install/ # 安装向导（@madong/install）
│ └── backend-mock/ # 接口 Mock（@vben/backend-mock）
├── packages/ # 公共包（@core / effects / business / lib / constants / types / icons / styles / utils）
├── internal/ # 内部工具与 lint 配置
├── scripts/ # 构建 / 校验脚本
├── docs/ # 文档站点
├── playground/ # 演练场
├── package.json
├── pnpm-workspace.yaml
└── turbo.json
| 版本 | 说明 |
|---|---|
| 5.x | 当前版本，前端独立大仓（本仓库），多租户 SaaS 前端，基于 Vben Admin |
非常欢迎你的加入！提一个 Issue 或提交 Pull Request。
- Fork 代码
- 创建分支：
git checkout -b feature/xxxx - 提交：
git commit -am 'feat(function): add xxxxx' - 推送：
git push origin feature/xxxx - 提交 Pull Request
参考 Conventional Commits：feat / fix / style / perf / refactor / revert / test / docs / chore / ci / types / wip。