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
- [Wiki](https://github.com/PanJiaChen/vue-element-admin/wiki)
P
Pan 已提交
34

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

花裤衩 已提交
37
**vue-element-admin is a admin interfaces integration solution, which is not suitable for secondary development as a base template.**
T
ttop5 已提交
38

花裤衩 已提交
39 40
 - 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 已提交
41

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

花裤衩 已提交
44
## Preparation
P
Pan 已提交
45

花裤衩 已提交
46
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/)[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 已提交
47

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

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

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

花裤衩 已提交
56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
## 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 已提交
72
- Dashboard
花裤衩 已提交
73 74 75 76 77 78 79 80
- Mock data
- Echarts
- Clipboard
- 401/404 error page
- Error log
- Export excel
- Export zip
- Front-end visualization excel
P
Pan 已提交
81
- Tree Table
P
Pan 已提交
82
- Table example
花裤衩 已提交
83 84 85
- Dynamictable example
- Drag and drop table example
- Inline edit table example
P
Pan 已提交
86
- Form example
花裤衩 已提交
87
- Two-step login
P
Pan 已提交
88
- SplitPane
P
Pan 已提交
89
- Drag Dialog
P
Pan 已提交
90 91 92
- Dropzone
- Sticky
- CountTo
93
- Markdown to html
花裤衩 已提交
94 95 96
```

## Getting started
P
refine  
Pan 已提交
97

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

花裤衩 已提交
102 103
# install dependency
npm install
P
refine  
Pan 已提交
104

花裤衩 已提交
105 106
# develop
npm run dev
P
refine  
Pan 已提交
107
```
P
refine  
Pan 已提交
108

花裤衩 已提交
109 110 111
This will automatically open http://localhost:9527.

## Build
P
Pan 已提交
112
```bash
花裤衩 已提交
113 114
# build for test environment
npm run build:sit
115

花裤衩 已提交
116 117
# build for production environment
npm run build:prod
118 119
```

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

花裤衩 已提交
125 126
# --preview to start a server in local to preview
npm run build:prod --preview
P
Pan 已提交
127

花裤衩 已提交
128 129
# lint code
npm run lint
P
refine  
Pan 已提交
130

花裤衩 已提交
131 132
# auto fix
npm run lint -- --fix
P
refine  
Pan 已提交
133 134
```

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

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

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

## Donate
花裤衩 已提交
144 145 146 147 148
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)
花裤衩 已提交
149

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

花裤衩 已提交
152 153
## License

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

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