153 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			153 lines
		
	
	
		
			6.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| <div align="center"> <a href="https://github.com/anncwb/vue-vben-admin"> <img alt="VbenAdmin Logo" width="215" src="https://unpkg.com/@vbenjs/static-source@0.1.7/source/logo-v1.webp"> </a> <br> <br>
 | ||
| 
 | ||
| [](LICENSE)
 | ||
| 
 | ||
| <h1>Vue Vben Admin</h1>
 | ||
| </div>
 | ||
| 
 | ||
| [](https://sonarcloud.io/summary/new_code?id=vbenjs_vue-vben-admin)    
 | ||
| 
 | ||
| **English** | [中文](./README.zh-CN.md) | [日本語](./README.ja-JP.md)
 | ||
| 
 | ||
| ## Introduction
 | ||
| 
 | ||
| Vue Vben Admin is a free and open source middle and back-end template. Using the latest `vue3`, `vite`, `TypeScript` and other mainstream technology development, the out-of-the-box middle and back-end front-end solutions can also be used for learning reference.
 | ||
| 
 | ||
| ## Upgrade Notice
 | ||
| 
 | ||
| This is the latest version, 5.0, and it is not compatible with previous versions. If you are starting a new project, it is recommended to use the latest version. If you wish to view the old version, please use the [v2 branch](https://github.com/vbenjs/vue-vben-admin/tree/v2).
 | ||
| 
 | ||
| ## Feature
 | ||
| 
 | ||
| - **Latest Technology Stack**: Developed with cutting-edge front-end technologies like Vue 3 and Vite
 | ||
| - **TypeScript**: A language for application-scale JavaScript
 | ||
| - **Themes**: Multiple theme colors available with customizable options
 | ||
| - **Internationalization**: Comprehensive built-in internationalization support
 | ||
| - **Permissions**: Built-in solution for dynamic route-based permission generation
 | ||
| 
 | ||
| ## Preview
 | ||
| 
 | ||
| - [Vben Admin](https://vben.pro/) - Full version Chinese site
 | ||
| 
 | ||
| Test Account: vben/123456
 | ||
| 
 | ||
| <p align="center">
 | ||
|     <img alt="VbenAdmin Logo" width="100%" src="https://anncwb.github.io/anncwb/images/preview1.png">
 | ||
|     <img alt="VbenAdmin Logo" width="100%" src="https://anncwb.github.io/anncwb/images/preview2.png">
 | ||
|     <img alt="VbenAdmin Logo" width="100%" src="https://anncwb.github.io/anncwb/images/preview3.png">
 | ||
| </p>
 | ||
| 
 | ||
| ### Use Gitpod
 | ||
| 
 | ||
| Open the project in Gitpod (free online dev environment for GitHub) and start coding immediately.
 | ||
| 
 | ||
| [](https://gitpod.io/#https://github.com/vbenjs/vue-vben-admin)
 | ||
| 
 | ||
| ## Documentation
 | ||
| 
 | ||
| [Document](https://doc.vben.pro/)
 | ||
| 
 | ||
| ## Install and use
 | ||
| 
 | ||
| - Get the project code
 | ||
| 
 | ||
| ```bash
 | ||
| git clone https://github.com/vbenjs/vue-vben-admin.git
 | ||
| ```
 | ||
| 
 | ||
| - Installation dependencies
 | ||
| 
 | ||
| ```bash
 | ||
| cd vue-vben-admin
 | ||
| 
 | ||
| corepack enable
 | ||
| 
 | ||
| pnpm install
 | ||
| ```
 | ||
| 
 | ||
| - run
 | ||
| 
 | ||
| ```bash
 | ||
| pnpm dev
 | ||
| ```
 | ||
| 
 | ||
| - build
 | ||
| 
 | ||
| ```bash
 | ||
| pnpm build
 | ||
| ```
 | ||
| 
 | ||
| ## Change Log
 | ||
| 
 | ||
| [CHANGELOG](https://github.com/vbenjs/vue-vben-admin/releases)
 | ||
| 
 | ||
| ## How to contribute
 | ||
| 
 | ||
| You are very welcome to join Or submit a Pull Request。
 | ||
| 
 | ||
| **Pull Request:**
 | ||
| 
 | ||
| 1. Fork code!
 | ||
| 2. Create your own branch: `git checkout -b feat/xxxx`
 | ||
| 3. Submit your changes: `git commit -am 'feat(function): add xxxxx'`
 | ||
| 4. Push your branch: `git push origin feat/xxxx`
 | ||
| 5. submit`pull request`
 | ||
| 
 | ||
| ## Git Contribution submission specification
 | ||
| 
 | ||
| - reference [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) specification ([Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))
 | ||
| 
 | ||
|   - `feat` Add new features
 | ||
|   - `fix` Fix the problem/BUG
 | ||
|   - `style` The code style is related and does not affect the running result
 | ||
|   - `perf` Optimization/performance improvement
 | ||
|   - `refactor` Refactor
 | ||
|   - `revert` Undo edit
 | ||
|   - `test` Test related
 | ||
|   - `docs` Documentation/notes
 | ||
|   - `chore` Dependency update/scaffolding configuration modification etc.
 | ||
|   - `ci` Continuous integration
 | ||
|   - `types` Type definition file changes
 | ||
|   - `wip` In development
 | ||
| 
 | ||
| ## Browser support
 | ||
| 
 | ||
| The `Chrome 80+` browser is recommended for local development
 | ||
| 
 | ||
| Support modern browsers, not IE
 | ||
| 
 | ||
| | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
 | ||
| | :-: | :-: | :-: | :-: | :-: |
 | ||
| | not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
 | ||
| 
 | ||
| ## Maintainer
 | ||
| 
 | ||
| [@Vben](https://github.com/anncwb)
 | ||
| 
 | ||
| ## Star History
 | ||
| 
 | ||
| [](https://star-history.com/#vbenjs/vue-vben-admin&Date)
 | ||
| 
 | ||
| ## Donate
 | ||
| 
 | ||
| If you think this project is helpful to you, you can help the author buy a cup of coffee to show your support!
 | ||
| 
 | ||
| 
 | ||
| 
 | ||
| <a style="display: block;width: 100px;height: 50px;line-height: 50px; color: #fff;text-align: center; background: #408aee;border-radius: 4px;" href="https://www.paypal.com/paypalme/cvvben">Paypal Me</a>
 | ||
| 
 | ||
| ## Contributor
 | ||
| 
 | ||
| <a href="https://github.com/vbenjs/vue-vben-admin/graphs/contributors">
 | ||
|   <img alt="Contributors"
 | ||
|         src="https://opencollective.com/vbenjs/contributors.svg?button=false" />
 | ||
| </a>
 | ||
| 
 | ||
| ## Discord
 | ||
| 
 | ||
| - [Github Discussions](https://github.com/anncwb/vue-vben-admin/discussions)
 | ||
| 
 | ||
| ## License
 | ||
| 
 | ||
| [MIT © Vben-2020](./LICENSE)
 | 
