English | Spanish

Introduction.

adempiere-vue is a new UI for ADempiere ERP, CRM & SCM]. It based on vue and use the UI Toolkit element-ui.

It is a great UI for ADempiere ERP, CRM & SCM based on the newest development stack of vue, built-in i18n solution, typical templates for enterprise applications, lots of awesome features. This project was forked from Vue-Element-Admin originally write by PanJiaChen / 花裤衩 over MIT license and was changed to GNU/GPL v3 by Yamel Senih after forked granted by PanJiaChen / 花裤衩 on issue "Extend as GNU/Gpl v3 License #1434".

adempiere-vue use the modern open source high performance RPC framework that can run in any environment gRPC as server.

• Live Preview

  • User: GardenAdmin
  • Password: GardenAdmin

• Documentation

• Gitter

• Donate

• Wiki

• Forked From

The current version is v1.0+ build on vue-cli. If you find a problem, please put issue.

This project does not support low version browsers (e.g. IE). Please add polyfill by yourself.

Preparation

You need to install node and git locally. The project is based on ES2015+, vue, vuex, vue-router, vue-cli , gRPC and element-ui. Understanding and learning this knowledge in advance will greatly help the use of this project.

For all enviroment you should run the follow images:

• ADempiere gRPC: https://hub.docker.com/r/erpya/adempiere-grpc-all-in-one

docker pull erpya/adempiere-grpc-all-in-one

• Proxy ADempiere API: https://hub.docker.com/r/erpya/proxy-adempiere-api

docker pull erpya/proxy-adempiere-api

• ADempiere Vue: https://hub.docker.com/r/erpya/adempiere-vue

docker pull erpya/adempiere-vue

Run docker container:

Minimal Docker Requirements

To use this Docker image you must have your Docker engine release number greater than or equal to 3.0.

Build docker image (for development only):

docker build -t solopcloud/adempiere-vue:dev -f ./Dockerfile .

Download docker image:

docker pull solopcloud/adempiere-vue

Run container container:

docker run -it \
	--name adempiere-vue \
	-p 80:80 \
	-e API_URL="http://localhost:8080/api/" \
	-e TZ="America/Caracas" \
	solopcloud/adempiere-vue

Or easy run container using docker-compose with follow command:

docker-compose up

Environment variables for the configuration

• PUBLIC_PATH: You will need to set publicPath if you plan to deploy your site under a sub path, for example GitHub Pages. If you plan to deploy your site to https://adempiere-vue.github.io/bar/, then publicPath should be set to /bar/. In most cases please use /.

• API_URL: It indicates the address of the server to which you will point the service ADempiere-UI-Gateway, by default its value is http://localhost:8080/api/.

• TASK_MANAGER_URL: It indicates the address of the API RESTFul to task manager ADempiere-Business-Processors and dKron, by default its value is http://localhost:8080/v1.

• TZ: (Time Zone) Indicates the time zone to set in the nginx-based container, the default value is America/Caracas (UTC -4:00).

Note If you do not change the values of the environment variables, it is not necessary to indicate them in the docker run command, since the default values will be set.

Sponsors

Become a sponsor and get your logo on our README on GitHub with a link to your site. Become a sponsor

Features

- Login / Logout
- Register
- Forgot Password

- Permission Authentication
  - ADempiere backend permission
  - Page permission
  - Directive permission
  - Permission configuration page

- Multi-environment build
  - Develop (dev)
  - sit
  - Stage Test (stage)
  - Production (prod)

- Global Features
  - I18n
  - Multiple dynamic themes
  - Dynamic sidebar (supports multi-level routing)
  - Dynamic breadcrumb
  - Tags-view (Tab page Support right-click operation)
  - Svg Sprite
  - Screenfull
  - Responsive Sidebar

- Editor
  - Rich Text Editor
  - Markdown Editor
  - JSON Editor

- Excel
  - Export Excel
  - Upload Excel
  - Visualization Excel
  - Export zip

- Table
  - Dynamic Table
  - Drag And Drop Table
  - Inline Edit Table

- Error Page
  - 401
  - 404

- Components
  - Avatar Upload
  - Back To Top
  - Drag Dialog
  - Drag Select
  - Drag Kanban
  - Drag List
  - SplitPane
  - Dropzone
  - Sticky
  - CountTo

- ADempiere supported
  - Window
  - Process
  - Report
  - Smart Browser
  - Form
  - Workflow

- Advanced Example
- Error Log
- Dashboard
- Guide Page
- ECharts
- Clipboard
- Markdown to html

Getting started

Use gRPC ADempiere Server as gRPC provider.

# Enable https to install packages
git config --global url."https://".insteadOf git://

# clone the project
git clone -b experimental https://github.com/solop-develop/frontend-core.git

# enter the project directory
cd frontend-core

# install dependency (yarn install --frozen-lockfile)
yarn ci

# run project as develop
yarn dev

This will automatically open http://localhost:9527

Build

# build for test environment
yarn build:stage

# build for production environment
yarn build:prod

Advanced

# preview the release environment effect
yarn preview

# preview the release environment effect + static resource analysis
yarn preview --report

# code format check
yarn lint

# code format check and auto fix
yarn lint --fix

Refer to Documentation for more information

Changelog

Detailed changes for each release are documented in the release notes.

Online Demo

Live Preview

• User: GardenAdmin
• Password: GardenAdmin

Donate

If you find this project useful, you can help this make a better UI

Paypal Me

Some Contributors

Thanks you for any effort to improve this great project. The follows are some companies that paying for help us to make a best software.

Browsers support

Modern browsers and Internet Explorer 10+

IE / Edge	Firefox	Chrome	Safari
IE10, IE11, Edge	last 2 versions	last 2 versions	last 2 versions

License

GNU/GPL v3

Previous License

MIT

Initial Contributors

• Yamel Senih
• Raúl Muñoz
• Edwin Betancourt
• Leonel Matos
• Elsio Sanchez