soybean-admin

<div align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/e263eeb2-df77-464c-9812-7d17bcd20e1e.svg" width="160" /> <h1>SoybeanAdmin</h1> <span>英文 | <a href="./README.zh_CN.md">中文</a></span> </div>

---

<a href="https://hellogithub.com/repository/1298f27d5fe54959a16cf9686516ddb3" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=1298f27d5fe54959a16cf9686516ddb3&claim_uid=IiDXWmP4TEntjbV" alt="推荐｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>

[!注意] 如果你认为SoybeanAdmin对你有帮助，或者你喜欢我们的项目，请在GitHub上给我们一个⭐️。你的支持是我们继续改进和添加新功能的动力！感谢你的支持！

简介

SoybeanAdmin是一个干净、优雅、美观且功能强大的管理模板，基于最新的前端技术栈，包括Vue3、Vite5、TypeScript、Pinia和UnoCSS。它内置了丰富的主题配置和组件、严格的代码规范和自动化的文件路由系统。此外，它还使用了基于ApiFox的在线模拟数据解决方案。SoybeanAdmin为你提供了一站式的管理解决方案，无需额外配置，开箱即用。它也是快速学习前沿技术的最佳实践。

特性

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

版本

• NaiveUI版本：

  • 预览链接
  • Github仓库
  • Gitee仓库

• AntDesignVue版本：

  • 预览链接
  • Github仓库
  • Gitee仓库

• 旧版本：

  • 预览链接
  • Github仓库

文档

• 链接
• 旧版文档

示例图片

使用

环境准备

确保你的环境满足以下要求：

• git：你需要git来克隆和管理项目版本。
• NodeJS：>=18.12.0，推荐18.19.0或更高版本。
• pnpm：>= 8.7.0，推荐8.14.0或更高版本。

克隆项目

git clone https://github.com/soybeanjs/soybean-admin.git

安装依赖

pnpm i

由于本项目使用pnpm monorepo管理方式，请不要使用npm或yarn安装依赖。

启动项目

pnpm dev

构建项目

pnpm build

生态系统

• react-soybean-admin：基于SoybeanAdmin的React版本。
• electron-mock-admin：一个帮助前端开发人员快速实现接口模拟的Mock Api管理系统。
• T-Shell：一个带有可配置命令提示符的终端模拟器和SSH客户端。
• pea：采用SpringBoot3.2 + JDK21、MyBatis-Plus、SpringSecurity安全框架等，适用于soybean-admin开发的简单权限系统。
• MalusAdmin：基于Vue3/TypeScript/NaiveUI和NET7 & Sqlsugar开发的后台管理框架。以最原始和最简单的方式实现，前端清新优雅，后端结构清晰优雅，功能强大。
• PanisAdmin：采用SpringBoot 3、SaToken、MySQL等框架，对soybean-admin进行二次开发和修改，适配动态菜单/按钮级别授权。保留原有风味，清新优雅，高颜值的后台管理系统脚手架。
• snail-job：一个"高性能、高颜值、高活跃度"的分布式任务重试和任务调度平台。
• SuperApi：快速将您的想法变成在线稳定产品！无实体的库表构建，无实体库表的增删改查，支持15种条件查询，以及分页、列表、无限级树列表等功能的API部署！具备接口文档、Auth授权、接口流量限制、获取客户端真实IP、高级服务器缓存组件、动态API等特性，期待您的体验！
• FastSoyAdmin：一个基于FastAPI+Vue3+Naive UI的现代管理平台。

如何贡献

我们热烈欢迎并感谢各种形式的贡献。如果您有任何想法或建议，请随时通过提交拉取请求或创建GitHub问题来分享。

Git提交指南

本项目内置了commit命令，您可以执行pnpm commit生成符合约定式提交规范的提交信息。在提交PR时，请务必使用commit命令创建提交信息，以确保信息的规范化。

浏览器支持

建议在开发中使用最新版本的Chrome以获得更好的体验。

<img src="https://yellow-cdn.veclightyear.com/835a84d5/00e92c35-251d-4a01-b9e2-b0c09a6947cb.png" alt="IE" width="24px" height="24px" />	<img src="https://yellow-cdn.veclightyear.com/835a84d5/e4b3ff18-1335-4b55-ab59-4e4a8e0edf5f.png" alt=" Edge" width="24px" height="24px" />	<img src="https://yellow-cdn.veclightyear.com/835a84d5/94dedb3e-b4be-4931-9170-2c7b2c639054.png" alt="Firefox" width="24px" height="24px" />	<img src="https://yellow-cdn.veclightyear.com/835a84d5/cb2d5c76-f38f-45f3-869e-8e2d3bd7f2b9.png" alt="Chrome" width="24px" height="24px" />	<img src="https://yellow-cdn.veclightyear.com/835a84d5/541aff29-2da0-40e9-80d4-07c661d2fb7b.png" alt="Safari" width="24px" height="24px" />
不支持	最新两个版本	最新两个版本	最新两个版本	最新两个版本

开源作者

Soybean

贡献者

感谢以下人员的贡献。如果您想为本项目做出贡献，请参考如何贡献。

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

交流

SoybeanAdmin是一个完全开源和免费的项目，帮助开发者更便捷地开发中大型管理系统。它还提供了微信和QQ交流群。如果您有任何问题，请随时在群里提问。

<div> <p>QQ群</p> <img src="https://yellow-cdn.veclightyear.com/835a84d5/f38e09f8-2758-4dfd-8bc3-c353be306006.jpg" style="width:200px" /> </div> <div> <p>添加以下微信邀请进入微信群</p> <img src="https://yellow-cdn.veclightyear.com/835a84d5/6b711d21-a658-4a40-8ca1-7c4f1abe9144.jpg" style="width:200px" /> </div>

Star趋势

许可证

本项目基于MIT © 2021 Soybean协议，仅供学习使用，商业使用请保留作者版权信息，作者不保证也不负责软件的使用。