Skip to content
Snippets Groups Projects
README.md 5.02 KiB
Newer Older
  • Learn to ignore specific revisions
  • 花裤衩's avatar
    花裤衩 committed
    <p align="center">
    
    花裤衩's avatar
    花裤衩 committed
      <img width="320" src="https://wpimg.wallstcn.com/ecc53a42-d79b-42e2-8852-5126b810a4c8.svg">
    
    花裤衩's avatar
    花裤衩 committed
    </p>
    
    
    花裤衩's avatar
    花裤衩 committed
    <p align="center">
    
      <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">
    
    Pan's avatar
    Pan committed
        <img src="https://img.shields.io/badge/element--ui-2.3.0-brightgreen.svg" alt="element-ui">
    
      </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>
    
    花裤衩's avatar
    花裤衩 committed
    </p>
    
    花裤衩's avatar
    花裤衩 committed
    
    
    花裤衩's avatar
    花裤衩 committed
    English | [简体中文](./README.zh-CN.md)
    
    花裤衩's avatar
    花裤衩 committed
    
    
    花裤衩's avatar
    花裤衩 committed
    ## Introduction
    
    花裤衩's avatar
    花裤衩 committed
    
    
    花裤衩's avatar
    花裤衩 committed
    `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.
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    - [Preview](http://panjiachen.github.io/vue-element-admin)
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    - [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/)
    
    Pan's avatar
    Pan committed
    
    
    Pan's avatar
    Pan committed
    - [Gitter](https://gitter.im/vue-element-admin/discuss)
    
    
    Pan's avatar
    Pan committed
    - [Wiki](https://github.com/PanJiaChen/vue-element-admin/wiki)
    
    Pan's avatar
    Pan committed
    
    
    Pan's avatar
    Pan committed
    - [Donate](https://panjiachen.github.io/vue-element-admin-site/#/donate)
    
    花裤衩's avatar
    花裤衩 committed
    
    
    花裤衩's avatar
    花裤衩 committed
    **vue-element-admin is a admin interfaces integration solution, which is not suitable for secondary development as a base template.**
    
    ttop5's avatar
    ttop5 committed
    
    
    花裤衩's avatar
    花裤衩 committed
     - Base template recommends using: [vueAdmin-template](https://github.com/PanJiaChen/vueAdmin-template)  
     - Desktop: [electron-vue-admin](https://github.com/PanJiaChen/electron-vue-admin)
    
    Pan's avatar
    Pan committed
    
    
    Pan's avatar
    Pan committed
    **Note: This project uses element-ui@2.3.0+ version, so the minimum compatible vue@2.5.0+**
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    ## Preparation
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    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.
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
     **This project is not a scaffolding and is more of an integrated solution.**
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
     **This project does not support low version browsers (e.g. IE). Please add polyfill yourself if you need them.**
    
    Pan's avatar
    Pan committed
    
    
     <p align="center">
      <img width="900" src="https://wpimg.wallstcn.com/a5894c1b-f6af-456e-82df-1151da0839bf.png">
    </p>
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    ## 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
    
    Pan's avatar
    Pan committed
    - Dashboard
    
    花裤衩's avatar
    花裤衩 committed
    - Mock data
    - Echarts
    - Clipboard
    - 401/404 error page
    - Error log
    - Export excel
    - Export zip
    - Front-end visualization excel
    
    Pan's avatar
    Pan committed
    - Tree Table
    
    Pan's avatar
    Pan committed
    - Table example
    
    花裤衩's avatar
    花裤衩 committed
    - Dynamictable example
    - Drag and drop table example
    - Inline edit table example
    
    Pan's avatar
    Pan committed
    - Form example
    
    花裤衩's avatar
    花裤衩 committed
    - Two-step login
    
    Pan's avatar
    Pan committed
    - SplitPane
    
    Pan's avatar
    Pan committed
    - Drag Dialog
    
    Pan's avatar
    Pan committed
    - Dropzone
    - Sticky
    - CountTo
    
    - Markdown to html
    
    花裤衩's avatar
    花裤衩 committed
    ```
    
    ## Getting started
    
    Pan's avatar
    Pan committed
    
    
    Pan's avatar
    Pan committed
    ```bash
    
    Pan's avatar
    Pan committed
    # clone the project
    
    花裤衩's avatar
    花裤衩 committed
    git clone https://github.com/PanJiaChen/vue-element-admin.git
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    # install dependency
    npm install
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    # develop
    npm run dev
    
    Pan's avatar
    Pan committed
    ```
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    This will automatically open http://localhost:9527.
    
    ## Build
    
    Pan's avatar
    Pan committed
    ```bash
    
    花裤衩's avatar
    花裤衩 committed
    # build for test environment
    npm run build:sit
    
    花裤衩's avatar
    花裤衩 committed
    # build for production environment
    npm run build:prod
    
    花裤衩's avatar
    花裤衩 committed
    ## Advanced
    
    花裤衩's avatar
    花裤衩 committed
    # --report to build with bundle size analytics
    npm run build:prod --report
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    # --preview to start a server in local to preview
    npm run build:prod --preview
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    # lint code
    npm run lint
    
    Pan's avatar
    Pan committed
    
    
    花裤衩's avatar
    花裤衩 committed
    # auto fix
    npm run lint -- --fix
    
    Pan's avatar
    Pan committed
    ```
    
    
    花裤衩's avatar
    花裤衩 committed
    Refer to [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/deploy) for more information
    
    
    Pan's avatar
    Pan committed
    ## Changelog
    Detailed changes for each release are documented in the [release notes](https://github.com/PanJiaChen/vue-element-admin/releases).
    
    
    花裤衩's avatar
    花裤衩 committed
    [Preview](http://panjiachen.github.io/vue-element-admin)
    
    Pan's avatar
    Pan committed
    
    ## Donate
    
    花裤衩's avatar
    花裤衩 committed
    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)
    
    花裤衩's avatar
    花裤衩 committed
    
    
    花裤衩's avatar
    花裤衩 committed
    [Buy me a coffee](https://www.buymeacoffee.com/Pan)
    
    
    花裤衩's avatar
    花裤衩 committed
    ## License
    
    
    花裤衩's avatar
    花裤衩 committed
    [MIT](https://github.com/PanJiaChen/vue-element-admin/blob/master/LICENSE)
    
    
    Pan's avatar
    Pan committed
    Copyright (c) 2017-present PanJiaChen