soybean-admin-react 是一个清新优雅、高颜值且功能强大的后台管理模板，基于最新的前端技术栈，包括 React19、React-Router-Dom V7、Redux/Toolkit、Vite6、TypeScript 和 UnoCSS。它内置了丰富的主题配置和组件，代码规范严谨，并实现了自动化的文件路由系统。此外，还采用了基于 ApiFox 的在线 Mock 数据方案。
soybean-admin-react 为您提供了一站式的后台管理解决方案，无需额外配置，开箱即用。同样也是一个快速学习前沿技术的最佳实践示例。
soybean-admin-react 遵循 Ant Design 的设计理念，页面风格清新优雅、易于使用，相信您会喜欢它的页面布局与交互设计。
特性
- 前沿技术应用：采用 React19、React-Router-Dom V7、Redux/toolkit、Vite6、TypeScript、UnoCSS 等最新流行技术栈。
- 清晰的项目架构：使用 pnpm monorepo 架构，结构简洁明了，方便维护。
- 严格的代码规范：遵循 SoybeanJS 规范，内置 eslint、prettier、simple-git-hooks 等，保证代码的高质量和一致性。
- TypeScript 支持：支持严格的类型检查与大量内置 hook 的类型推导，只需定义简洁的类型，即可享受完善的类型提示。
- 丰富的主题配置：内置多种主题方案，完美结合 UnoCSS，实现灵活个性化的 UI 定制。
- 内置国际化方案：轻松支持多语言应用。
- 增强型路由功能：基于 React-Router V7 并扩展了类似 Next.js 的约定式文件路由，带来高效便捷的路由管理体验。
- 自动化文件路由系统：基于 Elegant Router 自动生成路由声明及导入，简化配置。
- 灵活的权限路由：同时支持前端静态路由与后端动态路由。
- 丰富的页面组件：内置常用页面（403、404、500 等）与布局组件、主题配置组件等，开箱即可使用。
- 命令行工具：内置丰富的 CLI 工具，用于 git 提交、删除文件、项目发布等操作。
- 移动端适配：完美支持移动端适配，自适应布局让您无需单独编写移动端代码。
- 良好的错误处理：在发生错误时可自动捕获，并显示友好界面，同时支持在组件内进行埋点监控上报。
版本
React 版本
Vue 版本
文档
- 文档仓库：soybean-admin-react-docs ，基于 Nextra 构建。如果发现文档有任何问题或可以改进的地方，欢迎随时提交 PR 帮助我们完善。
需要掌握的基础知识
本项目基于 React 19、Redux/toolkit、React-Router V7、Vite、TypeScript 等技术。如果您在开发前能对以下内容有所了解，将极大提升项目的上手效率与理解深度：
浏览器支持
本地开发推荐使用 Chrome 100+ 及更高版本。 现代浏览器均受支持，不支持 IE。
 IE |  Edge |  Firefox |  Chrome |  Safari |
|---|---|---|---|---|
| 不支持 | 支持最新2个版本 | 支持最新2个版本 | 支持最新2个版本 | 支持最新2个版本 |
团队理念
- 欢迎各位小伙伴一起交流、讨论，彼此学习、共同进步。
- 项目采用 MIT 开源协议，永久免费使用，无需担忧版权问题。
- 任何关于功能扩展、Bug 修复、或文档纠正的贡献都十分欢迎，也鼓励你提交 PR，哪怕只是修正一个错别字。
如何加入我们
- 本项目处于持续更新中，期待更多伙伴的加入。
- 只要你对项目发展有想法和热情，并能积极提出建议或提交 PR，我们都会非常欢迎。
- 我们会根据你的活跃度和贡献度来邀请你加入项目核心团队，与我们一同打造更优秀的前端框架。
问题反馈
- 如果在使用中遇到任何问题，或者有改进建议，欢迎在 GitHub Issues 中进行反馈。
- 或直接添加下方微信加入讨论群：
添加以下微信，受邀进交流群
祝福与展望
非常感谢你选择 soybean-admin-react，愿它能在你的工作和学习中带来便利与收获。祝所有使用者在工作和生活中都能顺利进步、健康平安。欢迎大家积极参与、贡献代码，共同将 soybean-admin-react 打造得更加完善与强大！
Last updated on