README.md 5.0 KB
Newer Older
花裤衩 已提交
1
<p align="center">
花裤衩 已提交
2
  <img width="320" src="https://wpimg.wallstcn.com/ecc53a42-d79b-42e2-8852-5126b810a4c8.svg">
花裤衩 已提交
3 4
</p>

花裤衩 已提交
5
<p align="center">
6 7 8 9
  <a href="https://github.com/vuejs/vue">
    <img src="https://img.shields.io/badge/vue-2.5.10-brightgreen.svg" alt="vue">
  </a>
  <a href="https://github.com/ElemeFE/element">
P
Pan 已提交
10
    <img src="https://img.shields.io/badge/element--ui-2.3.0-brightgreen.svg" alt="element-ui">
11 12 13 14 15 16 17 18 19 20
  </a>
  <a href="https://travis-ci.org/PanJiaChen/vue-element-admin" rel="nofollow">
    <img src="https://travis-ci.org/PanJiaChen/vue-element-admin.svg?branch=master" alt="Build Status">
  </a>
  <a href="https://github.com/PanJiaChen/vue-element-admin/blob/master/LICENSE">
    <img src="https://img.shields.io/github/license/mashape/apistatus.svg" alt="license">
  </a>
  <a href="https://github.com/PanJiaChen/vue-element-admin/releases">
    <img src="https://img.shields.io/github/release/PanJiaChen/vue-element-admin.svg" alt="GitHub release">
  </a>
花裤衩 已提交
21
</p>
花裤衩 已提交
22

花裤衩 已提交
23
English | [简体中文](./README.zh-CN.md)
花裤衩 已提交
24

花裤衩 已提交
25
## Introduction
花裤衩 已提交
26

花裤衩 已提交
27
`vue-element-admin` is a production-ready solution for admin interfaces. Based on [Vue.js](https://github.com/vuejs/vue) and use the UI Toolkit -- [element](https://github.com/ElemeFE/element). `vue-element-admin` is a magical vue admin, it based on the newest development stack of vue, built-in i18n solution, typical templates for enterprise applications, lots of awesome features. It helps you build a large complex Single-Page Applications. I believe whatever your needs are, this project will help you.
P
refine  
Pan 已提交
28

花裤衩 已提交
29
- [Preview](http://panjiachen.github.io/vue-element-admin)
P
Pan 已提交
30

花裤衩 已提交
31
- [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/)
P
refine  
Pan 已提交
32

P
Pan 已提交
33 34
- [Gitter](https://gitter.im/vue-element-admin/discuss)

P
Pan 已提交
35
- [Wiki](https://github.com/PanJiaChen/vue-element-admin/wiki)
P
Pan 已提交
36

P
Pan 已提交
37
- [Donate](https://panjiachen.github.io/vue-element-admin-site/#/donate)
花裤衩 已提交
38

H
HiiTea 已提交
39
**vue-element-admin is an admin interfaces integration solution, which is not suitable for secondary development as a base template.**
T
ttop5 已提交
40

花裤衩 已提交
41 42
 - Base template recommends using: [vueAdmin-template](https://github.com/PanJiaChen/vueAdmin-template)  
 - Desktop: [electron-vue-admin](https://github.com/PanJiaChen/electron-vue-admin)
P
Pan 已提交
43

P
Pan 已提交
44
**Note: This project uses element-ui@2.3.0+ version, so the minimum compatible vue@2.5.0+**
P
refine  
Pan 已提交
45

花裤衩 已提交
46
## Preparation
P
Pan 已提交
47

L
Liu Xinyu 已提交
48
You need to install [node](http://nodejs.org/) and [git](https://git-scm.com/) locally. The project is based on [ES2015+](http://es6.ruanyifeng.com/), [vue](https://cn.vuejs.org/index.html), [vuex](https://vuex.vuejs.org/zh-cn/), [vue-router](https://router.vuejs.org/zh-cn/) and [element-ui](https://github.com/ElemeFE/element). All data requests for this project are simulated using [Mock.js](https://github.com/nuysoft/Mock). It would be helpful if you have pre-existing knowledge on those.
P
Pan 已提交
49

花裤衩 已提交
50
 **This project is not a scaffolding and is more of an integrated solution.**
P
Pan 已提交
51

花裤衩 已提交
52
 **This project does not support low version browsers (e.g. IE). Please add polyfill yourself if you need them.**
P
Pan 已提交
53

54 55 56
 <p align="center">
  <img width="900" src="https://wpimg.wallstcn.com/a5894c1b-f6af-456e-82df-1151da0839bf.png">
</p>
P
refine  
Pan 已提交
57

花裤衩 已提交
58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
## Features
```
- Login / Logout
- Permission authentication
- Multi-environment build
- Dynamic sidebar (supports multi-level routing)
- Dynamic breadcrumb
- I18n
- Customizable theme
- Tags-view(Tab page Support right-click operation)
- Rich text editor
- Markdown editor
- JSON editor
- Screenfull
- Drag and drop list
- Svg Sprite
P
Pan 已提交
74
- Dashboard
花裤衩 已提交
75
- Guide Page
花裤衩 已提交
76 77 78 79 80 81 82 83
- Mock data
- Echarts
- Clipboard
- 401/404 error page
- Error log
- Export excel
- Export zip
- Front-end visualization excel
P
Pan 已提交
84
- Tree Table
P
Pan 已提交
85
- Table example
花裤衩 已提交
86 87 88
- Dynamictable example
- Drag and drop table example
- Inline edit table example
P
Pan 已提交
89
- Form example
花裤衩 已提交
90
- Two-step login
P
Pan 已提交
91
- SplitPane
P
Pan 已提交
92
- Drag Dialog
P
Pan 已提交
93 94 95
- Dropzone
- Sticky
- CountTo
96
- Markdown to html
花裤衩 已提交
97 98 99
```

## Getting started
P
refine  
Pan 已提交
100

P
refine  
Pan 已提交
101
```bash
P
Pan 已提交
102
# clone the project
花裤衩 已提交
103
git clone https://github.com/PanJiaChen/vue-element-admin.git
P
refine  
Pan 已提交
104

花裤衩 已提交
105 106
# install dependency
npm install
P
refine  
Pan 已提交
107

花裤衩 已提交
108 109
# develop
npm run dev
P
refine  
Pan 已提交
110
```
P
refine  
Pan 已提交
111

花裤衩 已提交
112 113 114
This will automatically open http://localhost:9527.

## Build
P
Pan 已提交
115
```bash
花裤衩 已提交
116 117
# build for test environment
npm run build:sit
118

花裤衩 已提交
119 120
# build for production environment
npm run build:prod
121 122
```

花裤衩 已提交
123
## Advanced
124
```bash
花裤衩 已提交
125 126
# --report to build with bundle size analytics
npm run build:prod --report
P
refine  
Pan 已提交
127

花裤衩 已提交
128 129
# --preview to start a server in local to preview
npm run build:prod --preview
P
Pan 已提交
130

花裤衩 已提交
131 132
# lint code
npm run lint
P
refine  
Pan 已提交
133

花裤衩 已提交
134 135
# auto fix
npm run lint -- --fix
P
refine  
Pan 已提交
136 137
```

花裤衩 已提交
138 139
Refer to [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/deploy) for more information

P
Pan 已提交
140 141 142
## Changelog
Detailed changes for each release are documented in the [release notes](https://github.com/PanJiaChen/vue-element-admin/releases).

143
## Online Demo
花裤衩 已提交
144
[Preview](http://panjiachen.github.io/vue-element-admin)
P
Pan 已提交
145 146

## Donate
花裤衩 已提交
147 148 149 150 151
If you find this project useful, you can buy author a glass of juice :tropical_drink:

![donate](https://wpimg.wallstcn.com/bd273f0d-83a0-4ef2-92e1-9ac8ed3746b9.png)

[Paypal Me](https://www.paypal.me/panfree23)
花裤衩 已提交
152

花裤衩 已提交
153 154
[Buy me a coffee](https://www.buymeacoffee.com/Pan)

花裤衩 已提交
155 156
## License

花裤衩 已提交
157 158
[MIT](https://github.com/PanJiaChen/vue-element-admin/blob/master/LICENSE)

P
Pan 已提交
159
Copyright (c) 2017-present PanJiaChen