一、开源项目简介

Soybean Admin 是一个基于 Vue3、Vite3、TypeScript、NaiveUI、Pinia 和 UnoCSS 的清新优雅的中后台模版，它使用了最新的前端技术栈，内置丰富的主题配置，有着极高的代码规范，基于 mock 实现的动态权限路由，开箱即用的中后台前端解决方案，也可用于学习参考。

二、开源协议

使用MIT开源协议

三、界面展示

项目示例图

四、功能概述

特性

• 最新技术栈：使用 Vue3/vite2 等前端前沿技术开发, 使用高效率的 npm 包管理器 pnpm
• TypeScript: 应用程序级 JavaScript 的语言
• 主题：丰富可配置的主题、暗黑模式，基于原子 css 框架 - UnoCss 的动态主题颜色
• 代码规范：丰富的规范插件及极高的代码规范
• 权限路由：基于文件的路由系统、基于 mock 的动态路由能快速实现后端动态路由
• 请求函数：基于 axios 的完善的请求函数封装，提供 Promise 和 hooks 两种请求函数，加入请求结果数据转换的适配器适配器

五、技术选型

安装使用

• 环境配置 本地环境需要安装 pnpm 7.x 、Node.js 14.18+ 和 Git
• 克隆代码

访问一飞开源：https://code.exmay.com/ 下载

• 安装依赖

pnpm i

• 运行

pnpm dev

• 打包

pnpm build

Docker 部署

• Docker 部署 Soybean
• 
  

docker run --name soybean -p 80:80 -d soybeanjs/soybean-admin:v0.9.6

• 访问 SoybeanAdmin

打开本地浏览器访问http://localhost

浏览器支持

本地开发推荐使用Chrome 90+ 浏览器

支持现代浏览器, 不支持 IE

IEEdgeFirefoxChromeSafarinot supportlast 2 versionslast 2 versionslast 2 versionslast 2 versions

工具配置

本项目推荐使用 VSCode 进行开发，项目里面已内置 VSCode 配置，包含推荐的插件和设置。

以下为推荐的插件：

• Auto Close Tag - 自动添加 HTML/XML 结束标签
• Auto Complete Tag - 为 HTML/XML 添加关闭标签和自动重命名成对的标签
• Auto Import - 自动查找、解析和提供所有可用导入的代码操作和代码完成
• Auto Rename Tag - 自动重命名成对的 HTML/XML 标签
• Color Highlight - 颜色高亮插件
• DotENV - 高亮.env 文件
• EditorConfig for VS Code - 统一不同编辑器的一些配置
• ESLint - 代码检查
• Git Graph - Git 图形化操作工具
• GitLens — Git supercharged - 显示具体某行代码的 git 信息
• Icônes - 搜索 iconify 图标的插件
• Iconify IntelliSense - Iconify 图标实时显示的插件
• javascript console utils - 提供快捷键 ctrl+l 直接输入 console.log()
• Material Icon Theme - 图标主题，显示文件和文件多种图标
• Path Intellisense - 智能显示导入的路径
• Prettier - Code formatter - 代码格式化插件
• UnoCSS - unocss 写法提示插件
• Vue Language Features (Volar) - volar 插件， Language support for Vue 3
• Vue VSCode Snippets - vue2、vue3 写法提示