<h1 align="center">vue-admin-box</h1>
<p align="center">
    <a href="https://github.com/vuejs/vue-next">
        <img src="https://img.shields.io/badge/vue3-3.0.5-brightgreen.svg" alt="vue">
    </a>
    <a href="https://github.com/element-plus/element-plus">
        <img src="https://img.shields.io/badge/elementPlus-^2.0.5-brightgreen.svg" alt="element-plus">
    </a>
    <a href="https://github.com/vitejs/vite">
        <img src="https://img.shields.io/badge/vite-^2.8.6-brightgreen.svg" alt="vite">
    </a>
    <a href="https://github.com/microsoft/TypeScript">
        <img src="https://img.shields.io/badge/typescript-4.1.3-brightgreen.svg" alt="typescript">
    </a>
    <a href="https://github.com/hsiangleev/element-plus-admin/blob/master/LICENSE">
        <img src="https://img.shields.io/github/license/mashape/apistatus.svg" alt="license">
    </a>
</p>

English | [简体中文](./README.zh-CN.md)

## summary

- [update version](./VERSION.md)
- After more than three months of iteration, version 1.0 was officially released on August 10, 2021, with four basic templates attached for everyone to use
- This open source project is developed by individuals and does not restrict any commercial use or personal research. Please click star to encourage me before using it
- All illegal and pornographic activities involved in this open source project have nothing to do with this source code. Please do not show yourself
- QQ communication group：912804007，Problems are raised in the group and can be solved in time

## Preview
if you are not in China, maybe you should download the project to show the demo or use a vpn to visit the online demo.
- [demo China](https://cmdparkour.gitee.io/vue-admin-box/)
- [demo World](https://cmdparkour.github.io/vue-admin-box/dist/)
- [github address](https://github.com/cmdparkour/vue-admin-box)
- [gitee address](https://gitee.com/cmdparkour/vue-admin-box)
- It is recommended to use yarn or cnpm for installation in China. NPM installation is prone to problems

## Basic Template
There are four basic templates, which are suitable for zero development and use, and can be found in [github](https://github.com/cmdparkour/vue-admin-box)、[gitee ](https://gitee.com/cmdparkour/vue-admin-box)View directly in the warehouse，The template is shown below:
1. template-ts-i18n template，container ts and internationalization [github](https://github.com/cmdparkour/vue-admin-box/tree/template-ts-i18n) [gitee](https://gitee.com/cmdparkour/vue-admin-box/tree/template-ts-i18n/) [demo](http://vue-admin-box-template.51weblove.com/ts-i18n/)
2. template-ts template，container ts，internationalization is not container [github](https://github.com/cmdparkour/vue-admin-box/tree/template-ts) [gitee](https://gitee.com/cmdparkour/vue-admin-box/tree/template-ts/) [demo](http://vue-admin-box-template.51weblove.com/ts)
3. template-js-i18n template，container js and internationalization [github](https://github.com/cmdparkour/vue-admin-box/tree/template-js-i18n) [gitee](https://gitee.com/cmdparkour/vue-admin-box/tree/template-js-i18n/) [demo](http://vue-admin-box-template.51weblove.com/js-i18n)
4. template-js template，container js，internationalization is not container [github](https://github.com/cmdparkour/vue-admin-box/tree/template-js) [gitee](https://gitee.com/cmdparkour/vue-admin-box/tree/template-js/) [demo](http://vue-admin-box-template.51weblove.com/js)

## Introduction

**vue-admin-box** is a free and open source background management system template。The latest vue-next, vite, element-plus used in this project. The purpose is to solve the complex configuration of background system in general business。

#### Characteristic function

- Routing configuration, state management mechanism (State supports local storage by default), encapsulated and perfect Axios and API management mechanism suitable for middle and background development
- It is very convenient to expand the theme configuration function, and supports three typical middle and background styles by default
- Routing configuration, state management mechanism (State supports local storage by default), encapsulated and perfect Axios and API management mechanism suitable for middle and background development
- For the three typical business tables of adding, deleting and modifying query, please see "CRUD table", "category table" and "tree table" in the "page column" for details
- The refresh function without route jump supports cache page refresh. At present, most frameworks do not support cache page refresh
- It is a convenient and extensible internationalization solution, and provides two sets of non internationalized basic templates and two sets of internationalized basic templates (TS version / JS version)
- Handwritten versions of various custom instructions
- For table common components and pop-up common components that have been verified by multiple middle and background businesses, please see "crud table", "category table" and "tree table" in the "page column" for details

#### Main technology

- MVVM framework：vue v3
- Engineering Management：vite v2
- UI framework：element-plus
- Router manage：vue-router v4
- State Manage ：vuex v4
- Data request：axios
- Utility library：@vueuse/core

## How to use

1. get the source code project

   ```
   git clone https://github.com/cmdparkour/vue-admin-box.git
   ```

   

2. install dependence, you can use cnpm or yarn in China

   ```
   npm install
   ```

   

3. run in the development

   ```
   npm run dev 或 npm run start
   ```

   

4. build in production

   ```
   npm run build
   ```
   
## Partner project
* [Thinker-Admin-Box - springboot with vue-admin-box, use java code to generate vue page](https://github.com/yirius/thinker-admin-box)
* [H5-dooring - a low code project about the mobile website](http://h5.dooring.cn)
* [ant-simple-pro - a middle website based on Vue3.0, react and angular](https://github.com/lgf196/ant-simple-pro)
* [vue-vben-admin - a modern vue admin. It is based on Vue3, vite and TypeScript. It's fast！](https://github.com/vbenjs/vue-vben-admin)


## preview

<p align="center">
    <img src="http://blog.51weblove.com/wp-content/uploads/2021/08/QQ截图20210810174824.png">
    <img src="http://blog.51weblove.com/wp-content/uploads/2021/08/QQ截图20210810174848.png">
    <img src="http://blog.51weblove.com/wp-content/uploads/2021/08/QQ截图20210810174923.png">
    <img src="http://blog.51weblove.com/wp-content/uploads/2021/08/QQ截图20210810174940.png">
    <img src="http://blog.51weblove.com/wp-content/uploads/2021/08/QQ截图20210810175009.png">
</p>
