Development

Software prerequisites

Installation

First clone the backoffice repository

git clone [email protected]:one.exp/uni/backoffice.git

Then run the following commands:

# install dependencies
npm install
# serve with hot reload at localhost:8080
npm run serve
# build for production with minification
npm run build

Configuration

To run the application you need to provide a .env file to configure all required settings. Here is a list of all environment variables:

# For development only
VUE_APP_MODE=development
VUE_APP_HOT_RELOAD=true
# GATEWAY_URL - default urls to communicate to the OneX backend services (make sure to only use one variable, preferably dev or staging)
VUE_APP_GATEWAY_URL=https://api.staging.hrg.onex.run/
#VUE_APP_GATEWAY_URL=https://api.dev.hrg.onex.run/
#VUE_APP_GATEWAY_URL=https://api.prod.hrg.onex.run/

Recommended tools

Vue-Devtools

Vue Browser extension to debug and inspect your Vue.js website.

Noteworthy dependencies

  • vue - Progressive framework for building user interfaces. It is designed from the ground up to be incrementally adoptable, and can easily scale between a library and a framework depending on different use cases. It consists of an approachable core library that focuses on the view layer only, and an ecosystem of supporting libraries that helps you tackle complexity in large Single-Page Applications.
  • vuex - Centralized State Management for Vue.js.
  • vue-router - The official router for Vue.js. It deeply integrates with Vue.js core to make building Single Page Applications with Vue.js a breeze.