# clean-admin

**Repository Path**: guolixun/clean-admin

## Basic Information

- **Project Name**: clean-admin
- **Description**: 一个纯净的，基于vite+vue3+ts构建的后台管理框架，采用原生的方式，没有额外加入乱七八糟的各种扩展和组件，仅使用了pinia+antd-design-vue+axios, 模板中实现了RBAC的权限菜单之外，不在额外补充其它功能。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2024-12-23
- **Last Updated**: 2025-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 <div style="text-align: center">
  <img src="https://gitee.com/guolixun/clean-admin/raw/master/src/assets/logo.png" width="100" height="100" alt="" />
 </div>


## 💡 简介

clean Admin Vite 是一个免费开源的中后台管理系统基础解决方案，基于 Vue3、Vite、TypeScript、Ant Design Vue、Pinia 等主流技术

## 📣 通知

> ⚠︎
> 为爱发电！所有源码均免费开源，如果对你有帮助，欢迎点个 Star 支持一下！

> ℹ
> 欢迎体验全新的 1.0 版本，目前正在 beta 阶段，它将是一次匠心之作！

<!-- > [!WARNING]
> 4.x 版本如果没有严重的 BUG 将不再维护！[点击切换到 4.x 分支](https://github.com/un-pany/v3-admin-vite/tree/4.x)

> [!TIP]
> 正式推出付费服务，如果不想自己动手，但想移除 TS 或其他模块？试试懒人套餐！[点击看看](https://github.com/un-pany/v3-admin-vite/issues/225) -->

## 🎮 使用

<details>
<summary>推荐环境</summary>

<br>

- 新版 `Visual Studio Code`
- 安装 `.vscode/extensions.json` 文件中推荐的插件
- `node` 20.x 或 22+
- `pnpm` 9+

</details>

<details>
<summary>本地开发</summary>

<br>

```
# 克隆项目
git clone https://gitee.com/guolixun/clean-admin.git

# 进入项目目录
cd clean-admin

# 安装依赖
pnpm i

# 启动服务
pnpm dev
```

</details>

<details>
<summary>打包构建</summary>

<br>

```bash
# 打包构建生产环境
pnpm build
```

</details>

<details> 
<summary>代码提交规范</summary>

<br>

`feat` 新功能

`fix` 修复错误

`perf` 优化

`refactor` 重构代码

`docs` 文档和注释

`types` 类型相关

`test` 单测相关

`ci` 持续集成、工作流

`revert` 撤销更改

`chore` 琐事（更新依赖、修改配置等）

</details>


## 📋️ 项目示例

![welcome](https://gitee.com/guolixun/clean-admin/raw/master/public/welcome.png)
![](https://gitee.com/guolixun/clean-admin/raw/master/public/demo.png)
![](https://gitee.com/guolixun/clean-admin/raw/master/public/demo1.png)
![](https://gitee.com/guolixun/clean-admin/raw/master/public/demo2.png)