Awesome
<div align="center"> <img src="./public/favicon.svg" width="160" /> <h1>React SoybeanAdmin</h1> <span><a href="./README.en-US.md">English</a> | 中文</span> </div> ```[!NOTE] 如果您觉得
React SoybeanAdmin
对您有所帮助,或者您喜欢我们的项目,请在 GitHub 上给我们一个 ⭐️。您的支持是我们持续改进和增加新功能的动力!感谢您的支持!
简介
React Soybean
是一个清新优雅、高颜值且功能强大的后台管理模板,基于最新的前端技术栈,包括 React18,ReactRouter V6, Vite5, TypeScript, Redux/toolkit 和 UnoCSS。它内置了丰富的主题配置和组件,代码规范严谨,实现了自动化的文件路由系统。此外,它还采用了基于 ApiFox 的在线Mock数据方案。React Soybean
为您提供了一站式的后台管理解决方案,无需额外配置,开箱即用。同样是一个快速学习前沿技术的最佳实践。
版本
React版本
文档
Vue版本
特性
- 前沿技术应用:采用 React18, ReactRouter V6,Vite5, TypeScript, Redux/toolkit 和 UnoCSS 等最新流行的技术栈。
- 清晰的项目架构:采用 pnpm monorepo 架构,结构清晰,优雅易懂。
- 严格的代码规范:遵循 SoybeanJS 规范,集成了eslint, prettier 和 simple-git-hooks,保证代码的规范性。
- TypeScript: 通过支持严格的类型检查和内置多个 hook 的类型推导,仅需定义简洁的类型,即可享受便捷的 TypeScript 类型提示,显著提升代码的可维护性。
- 丰富的主题配置:内置多样的主题配置,与 UnoCSS 完美结合。
- 内置国际化方案:轻松实现多语言支持。
- 丰富的路由功能:基于 React-Router V6 扩展了路由 API,提供类似 Vue-Router 的便捷使用体验,让路由管理更加灵活高效。
- 自动化文件路由系统:约定式路由,自动生成路由导入、声明和类型。更多细节请查看 Elegant Router。
- 灵活的权限路由:同时支持前端静态路由和后端动态路由。
- 丰富的页面组件:内置多样页面和组件,包括403、404、500页面,以及布局组件、标签组件、主题配置组件等。
- 命令行工具:内置高效的命令行工具,git提交、删除文件、发布等。
- 移动端适配:完美支持移动端,实现自适应布局。
- 良好UI:在发生错误的时候自动捕获错误,并显示友好界面,帮助用户快速定位和解决问题,还可以再组件内监控埋点上报。
符合Ant Design风格的保姆级文档
示例图片
使用
环境准备
确保你的环境满足以下要求:
- 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
如何贡献
我们热烈欢迎并感谢所有形式的贡献。如果您有任何想法或建议,欢迎通过提交 pull requests 或创建 GitHub issue 来分享。
Git 提交规范
本项目已内置 commit
命令,您可以通过执行 pnpm commit
来生成符合 Conventional Commits 规范的提交信息。在提交PR时,请务必使用 commit
命令来创建提交信息,以确保信息的规范性。
浏览器支持
推荐使用最新版的 Chrome 浏览器进行开发,以获得更好的体验。
开源作者
贡献者
感谢以下贡献者的贡献。如果您想为本项目做出贡献,请参考 如何贡献。
<a href="https://github.com/mufeng889/react-soybean-admin/graphs/contributors"> <img src="https://contrib.rocks/image?repo=mufeng889/react-soybean-admin" /> </a>交流
React Soybean
是完全开源免费的项目,在帮助开发者更方便地进行中大型管理系统开发,同时也提供微信和 QQ 交流群,使用问题欢迎在群内提问。
开源协议
项目基于 MIT © 2021 Soybean 协议,仅供学习参考,商业使用请保留作者版权信息,作者不保证也不承担任何软件的使用风险。