SoybeanAdmin 是一个基于 Vue3、Vite、TypeScript、Pinia、NaiveUI 和 UnoCSS 的后台管理模板,采用 pnpm monorepo 组织,结构清晰、代码规范,克隆下来就能直接开始写业务页面。它内置多套主题配置、国际化方案和丰富的示例页面与布局组件,提供自动化文件路由系统,能自动生成路由导入、声明和类型。权限方面同时支持前端静态路由和后端动态路由,并配有在线 Mock 数据方案与命令行工具,让开发者在实现后台管理系统时,无需额外配置即可快速上手,也可作为学习当前主流前端技术栈的实践项目。除 NaiveUI 版本外,还提供 AntDesignVue、ElementPlus 等适配版本。
pnpm install && pnpm dev中文 | English
[!NOTE] 如果您觉得
SoybeanAdmin对您有所帮助,或者您喜欢我们的项目,请在 GitHub 上给我们一个 ⭐️。您的支持是我们持续改进和增加新功能的动力!感谢您的支持!
[!NOTE]
SoybeanAdmin快速上手系列视频已在 上线 前往查看
[!IMPORTANT]
SoybeanAdmin3.0 版本正在开发中,将基于 ubean 全栈框架与 VeanUI 组件库进行整体重构,进展与方案请查看 Roadmap Issue #941。
[!WARNING]
2.3将是 2.x 系列最后一个维护的大版本。2.x 后续只在该版本上提供维护更新,新特性将集中在 3.0 中实现,建议新项目关注 3.0 进展。
[](https://veanui.com)
[](https://veanui.com)
面向 Vue 3 的强大而优雅的组件系统,提供 Aria 层交互能力与开箱即用的样式封装。
采用 Aria + UI 两层架构,复用底层交互能力,统一上层界面表达。



[](https://veanui.com)
SoybeanAdmin 是一个清新优雅、高颜值且功能强大的后台管理模板,基于最新的前端技术栈,包括 Vue3, Vite8, TypeScript, Pinia 和 UnoCSS。它内置了丰富的主题配置和组件,代码规范严谨,实现了自动化的文件路由系统。此外,它还采用了基于 ApiFox 的在线Mock数据方案。SoybeanAdmin 为您提供了一站式的后台管理解决方案,无需额外配置,开箱即用。同样是一个快速学习前沿技术的最佳实践。
[!IMPORTANT] 3.0 版本正在开发中(Roadmap Issue #941);
2.3是 2.x 系列最后一个维护的大版本。
我们非常感谢大家对 SoybeanAdmin 的支持!为了进一步回馈社区,并助力企业和开发者实现个性化需求,我们现提供多种合作服务,期待与您携手共赢。
针对企业和开发者的特定业务需求,我们提供基于 SoybeanAdmin 的定制化管理后台开发服务。我们的团队具备丰富的行业经验,能够迅速理解并实现您的需求,打造高效、灵活且安全的定制化解决方案。
SoybeanAdmin 基础上,扩展您所需的特定功能模块,提升管理后台的功能和用户体验。我们承接各类企业级外包项目,特别是在管理后台系统的开发、集成与运维方面。我们以精益求精的态度,确保项目的质量和进度,为您的业务提供强有力的技术支持。
SoybeanAdmin 的系统集成与长期维护服务,确保您的系统稳定、安全地运行。如有合作意向或项目咨询,请通过以下方式与我们联系:
期待与您开展深入合作,共同推动 SoybeanAdmin 项目及其在更多领域的成功应用!

环境准备
确保你的环境满足以下要求:
克隆项目
# github
git clone https://github.com/soybeanjs/soybean-admin.git
# gitee
git clone https://gitee.com/honghuangdc/soybean-admin.git
# gitcode
git clone https://gitcode.com/soybeanjs/soybean-admin.git
安装依赖
pnpm i
由于本项目采用了 pnpm monorepo 的管理方式,因此请不要使用 npm 或 yarn 来安装依赖。
启动项目
pnpm dev
构建项目
pnpm build
代码同步
参考 代码同步 文档。
更多周边生态请翻阅 周边生态 文档。
我们热烈欢迎并感谢所有形式的贡献。如果您有任何想法或建议,欢迎通过提交 pull requests 或创建 GitHub issue 来分享。
本项目已内置 commit 命令,您可以通过执行 pnpm commit 来生成符合 Conventional Commits 规范的提交信息。在提交PR时,请务必使用 commit 命令来创建提交信息,以确保信息的规范性。
推荐使用最新版的 Chrome 浏览器进行开发,以获得更好的体验。
感谢以下贡献者的贡献。如果您想为本项目做出贡献,请参考 如何贡献。
以下是近一年中活跃度较高的贡献者,感谢各位的支持,让项目得以持续发展。
SoybeanAdmin 是完全开源免费的项目,在帮助开发者更方便地进行中大型管理系统开发,同时提供飞书群供大家交流,使用问题欢迎在群内提问。
飞书群

项目基于 MIT © 2021 Soybean 协议,仅供学习参考,商业使用请保留作者版权信息,作者不保证也不承担任何软件的使用风险。
内容由编辑整理,部分信息来自 GitHub 与项目官网,版权归原作者所有。发现错误?报告问题