# xh-admin-frontend

**Repository Path**: sun-xiaohan/xh-admin-frontend

## Basic Information

- **Project Name**: xh-admin-frontend
- **Description**: XHan Admin （前端）（晓寒管理系统）是一个开源免费（前后端分离）中后台管理系统基础解决方案, 无专业版收费。最新技术栈 vue3 admin，vite7
后端： jdk21, springboot3, spring-cloud, spring-cloud-alibaba, SaToken等
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.xhansky.cn
- **GVP Project**: No

## Statistics

- **Stars**: 167
- **Forks**: 22
- **Created**: 2023-04-18
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img alt="XHan Admin" width="120" height="120" src="public/favicon.svg">
  <h1>XHan Admin</h1>
  XHan Admin（晓寒开源管理系统） 前端代码库
</div>

## ⚡ 介绍

XHan Admin（晓寒开源管理系统）是一个开源免费（前后端分离）中后台管理系统基础解决方案, 无专业版收费，所有功能毫无保留的贡献给开源社区。
前端技术栈： Vue3, TypeScript, Element Plus, Vite, Pinia等
后端技术栈： jdk21, springboot3, spring-cloud, spring-cloud-alibaba, SaToken等

前端代码库: [xh-admin-frontend](https://github.com/Alixhan/xh-admin-frontend)<br>
后端代码库: [xh-admin-backend](https://github.com/Alixhan/xh-admin-backend)

gitee 码云代码仓库<br>
前端代码库: [xh-admin-frontend](https://gitee.com/sun-xiaohan/xh-admin-frontend)<br>
后端代码库: [xh-admin-backend](https://gitee.com/sun-xiaohan/xh-admin-backend)

## 📚 文档

[官方文档](http://www.xhansky.cn)

## 📺 在线演示

[演示站](http://demo.xhansky.cn)

## ❤️ Generate electricity with love

- **完全免费**：觉得不错的话，点个star吧，感谢感谢，star是作者唯一的动力！
- **最新技术栈**：体验最新技术栈带来的开发效率和开发体验的巨大提升
- **完全响应式布局**：各端均做了响应性布局适配，移动端也可以愉快的使用。
- **通用组件**: 统一的组件封装，保证样式功能统一，开发更规范，效率更高，包括表格组件，表单组件，excel导入组件，图片统一上传管理，裁剪组件等
- **纯净的代码**: 从零用最新技术栈全新搭建，无任何历史包袱，只包含核心纯净的代码。
- **漂亮的样式**: 漂亮的样式设计，赶快试试吧。
- **丰富的主题**: 内置各种颜色主题，支持暗黑模式。
- **代码生成器**: 通过代码生成器，保证项目总体代码风格统一并极大加快增删改查的开发效率。

## 内置功能模块
- **菜单管理**
- **用户组管理**
- **用户管理**
- **机构管理**
- **角色管理**
- **文件管理**
- **数据字典**
- **系统监控**
- **多角色切换**
- **数据权限**
- **代码生成器**

## 🚀 开始使用

```bash
# requirement
node version 20+
pnpm version 9+

# clone
git clone https://github.com/Alixhan/xh-admin-frontend

# enter the project directory
cd xh-admin-frontend

# install dependencies
pnpm i

# start the service
pnpm dev
```

## ✔️ 打包发布

```bash
# prod environment
pnpm build:production
```

## 🔧 代码检查

```bash
# code formatting
pnpm format

# unit test
pnpm test
```

## Git 提交规范

**按照Angular提交标准来**<br>
各大IDE开发工具均可安装git提交规范插件，JetBrains: `Git Commit Message Helper`,Vscode: `git commit plugin`

* `feat` - A new feature
* `fix` - A bug fix
* `docs` - Documentation only changes
* `style` - Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
* `refactor` - A code change that neither fixes a bug nor adds a feature
* `perf` - A code change that improves performance
* `test` - Adding missing tests or correcting existing tests
* `build` - Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
* `ci` - Changes to our Cl configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs
* `chore` - Other changes that don't modify src or test files
* `revert` - Reverts a previous commit

## 💕 贡献者

非常感谢!

<a href="https://github.com/Alixhan/xh-admin-frontend/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=Alixhan/xh-admin-frontend" />
</a>

## ☕ 捐赠

提交PR，提交issue，点个star，或者直接打赏我，哈哈哈~~~

## 交流群
欢迎加入微信交流群

扫码加我微信（备注：xhan），邀请您加入微信交流群

<img src="docs/public/image/wechat.png" width=200 />

## 📄 License

[Apache License 2.0](./LICENSE)

Copyright (c) 2023-present [sxh](https://github.com/Alixhan)