/vue-ace-admin

🔥 Vue Ace Admin,基于 Vue3.4、TypeScript、Vite5、Eslint9、Pinia、Antd-V4 开源的后台管理框架。

Primary LanguageVueMIT LicenseMIT

Ace Admin

Ace Admin

中文 | English

⚡ 简介

Ace Admin 目标是搭建一套免费开源的中后台管理系统,基于最新且最前沿的技术,无复杂封装、结构清晰、代码优雅、功能丰富、开箱即用,让你快速搭建一个精美的中后台管理系统。

Ace Admin 是一个基于 Vue3.4、TypeScript5.x、Antd-Vue4.x、Pinia2.x 及 Vite5.x 等前沿技术栈构建的免费开源中后台管理系统解决方案(后端服务通过Springboot3 + Java17 实现。)。在 Antd4 精美的主题基础上,我构建了一个清晰且高效的项目逻辑架构,整合了最新的技术框架。欢迎大家使用!

📚 文档

  • 使用文档:doc

📺 在线预览

位置 账号 密码 链接
vercel xoxosos666@gmail.com admin666 链接

❤️ 用爱发电

  • 完全免费:但希望你点一个 star⭐ !!!
  • 非常简洁:没有复杂的封装,没有复杂的类型体操,开箱即用
  • 详细的注释:各个配置项都写有尽可能详细的注释
  • 最新的依赖: 定期更新所有三方依赖至最新版
  • 有一点规整: 代码风格统一,命名风格统一,注释风格统一

📖 项目亮点

  • 前沿技术:Vue 3.4 最新周边生态。
  • Simple git hooks:尤大推荐(可代替husky)。
  • Antd-Vue:使用更精美的Ant-Design-Vue 4.x 版本。
  • Pinia: 传说中的 Vuex5 , 已集成 Pinia 持久化插件。
  • Vite:最新的 Vite5.x ,以快速著称的现代化构建工具(多环境)。
  • Vue Router:Vue Router 管理路由。
  • TypeScript:超越传统 JavaScript 语言的静态类型方案。
  • Pnpm:快速且节省空间的包管理工具。
  • Scss:用于定制布局和颜色风格。
  • ESLint9 & Prettier:代码校验与格式化工具。
  • Axios:网络请求库(优雅封装)。
  • 兼容移动端: 布局兼容移动端页面分辨率(开发中)。

📔 功能特色

  • 用户管理:登录、登出演示
  • RBAC权限管理:内置页面权限(动态路由)、路由守卫、指令权限、权限函数(coding)
  • Hooks:常用hooks封装
  • 多环境:多环境支持,适配开发、预发布和生产环境。
  • 多主题:内置普通、黑暗、自定义主题模式以及丰富的主题定制功能。
  • 多布局:内置左侧、顶部布局模式。
  • 错误页面: 错误处理页面,如403、404。
  • Dashboard:根据用户角色定制化显示。
  • 图标:支持 SVG组件、Iconfont、Iconify。
  • 其他内置功能:如Ai集成、TinyMCE编辑器、动态侧边栏、动态面包屑、标签页快捷导航、 全屏、自适应收缩侧边栏等

🚀 使用指南

使用前配置

  1. 环境准备
  2. node 版本推荐 18+/20+
  3. pnpm 版本推荐 8.x/9.x+
# 克隆项目
git clone https://github.com/xoxosos/vue-ace-admin.git
# 进入项目目录
cd vue-ace-admin
# 安装 pnpm (如已安装可跳过)
npm install pnpm -g
# 安装依赖
pnpm i
# 启动服务
pnpm dev

🔧 代码检查

# 代码检查与格式化,只需执行相应的命令。
pnpm lint

✔️ 预览

# 预览正式环境
pnpm preview

📦️ 多环境打包

# 构建预发布环境
pnpm build:test
# 构建正式环境
pnpm build:prod

✒️ Git 提交规范参考

Git 提交规范,包含了常见的提交类型,方便开发者追踪和管理变更。内置cz-git, 可直接在终端使用git cz进行交互式提交。

  • 参考 vue 规范 (Angular)

    • feat 增加新功能
    • fix 修复问题/BUG
    • style 代码风格相关无影响运行结果的
    • perf 优化/性能提升
    • refactor 重构
    • revert 撤销修改
    • test 测试相关
    • docs 文档/注释
    • chore 依赖更新/脚手架配置修改等
    • workflow 工作流改进
    • ci 持续集成
    • types 类型定义文件更改
    • wip 开发中

🖥️ 项目预览图

点击查看预览

🌏 浏览器支持

本地开发推荐使用现代浏览器Chrome 80+ 浏览器

不支持 IE

💕 感谢 Star

若您喜欢这个项目,请不吝赐予 ⭐star 支持,这是维护者持续更新的动力。(小声:毕竟是免费的)

📄 License

本项目采用 MIT 许可协议,版权归 CodexLin所有。

Copyright (c) 2023-Present CodexLin