SoybeanAdmin 1.0:清新与强大并存的后台管理解决方案

发表时间: 2024-04-02 10:51

历经6个月的重构,经过不断地打磨,SoybeanAdmin 1.0 终于发布了!

简介

SoybeanAdmin 是一个清新优雅、高颜值且功能强大的后台管理模板,基于最新的前端技术栈,包括 Vue3, Vite5, TypeScript, Pinia 和 UnoCSS。它内置了丰富的主题配置和组件,代码规范严谨,实现了自动化的文件路由系统。此外,它还采用了基于 ApiFox 的在线Mock数据方案。SoybeanAdmin 为您提供了一站式的后台管理解决方案,无需额外配置,开箱即用。同样是一个快速学习前沿技术的最佳实践。

特性

  • 前沿技术应用:采用 Vue3, Vite5, TypeScript, Pinia 和 UnoCSS 等最新流行的技术栈。
  • 清晰的项目架构:采用 pnpm monorepo 架构,结构清晰,优雅易懂。
  • 严格的代码规范:遵循 SoybeanJS 规范,集成了eslint, prettier 和 simple-git-hooks,保证代码的规范性。
  • TypeScript: 支持严格的类型检查,提高代码的可维护性。
  • 丰富的主题配置:内置丰富多样的主题配置,与 UI组件 和 UnoCSS 完美结合。
  • 内置国际化方案:轻松实现多语言支持。
  • 自动化文件路由系统:自动生成路由导入、声明和类型。更多细节请查看 Elegant Router。
  • 灵活的权限路由:同时支持前端静态路由和后端动态路由。
  • 丰富的页面组件:内置多样页面和组件,包括403、404、500页面,以及布局组件、标签组件、主题配置组件等。
  • 命令行工具:内置高效的命令行工具,git提交、删除文件、发布等。
  • 移动端适配:完美支持移动端,实现自适应布局。

特性细节

  • 严格的代码规范
    • 集成 eslint, prettier 和 simple-git-hooks,保证代码的规范性。
    • 使用 @soybeanjs/eslint-config
    • 项目中的 Vue 文件全部使用 script-setup 写法
    • 严格遵循各种命名规范,如文件命名、变量命名、函数命名等,更多细节请查看 SoybeanJS 命名规范。
    • 文件组织按照模块划分,可复用的组件放在全局的 components 文件夹下,页面的模块划分放在页面下的 modules 文件夹下。
    • 遵循函数编程的思想,尽量减少副作用,提高代码的可维护性。
  • 权限路由
    • 支持前端静态路由和后端动态路由。
    • 前端静态路由:在路由配置文件中配置路由,通过权限控制是否显示。
    • 后端动态路由:通过后端接口获取路由信息,实现动态路由。
    • 严谨的路由流程,保证路由的安全性,参考路由流程图

更多细节请查看 SoybeanAdmin 路由

  • 系统主题
    • 系统实现自己的主题配置层,再分别连接 UI组件 和 UnoCSS 的主题配置,实现主题的统一,完美兼容暗黑模式。
    • 主题颜色完美结合 UnoCSS,快速使用诸如 bg-primary、text-primary 等类名。
    • 提供丰富的主题配置,包括布局、主题颜色、页面元素属性控制等,详细见示例页面的主题配置抽屉。
  • TypeScript 最佳实践
    • 严格的类型检查,提高代码的可维护性。
    • 项目采用了TS的全局类型声明方式,快捷方便地使用全局类型。

更多技术细节请自行探索项目。

示例页面


作者:SoybeanJS
链接:
https://juejin.cn/post/7352245958594494502