hestia-touch-one-ui

ONE UI files shown on the touch LCD. Backend repository is here.

Development and compiling

Setup

Install nodejs LTS or later.

Run the following command to install fonts and other asset dependencies. This creates a /node_modules/ directory.

npm install

Generate a distributable web app folder

This creates a minified copy of the code in the /dist/ directory. The environment variable MQTT_SERVER specifies the ip address of the server where openHAB is running. Omit this environment variable to default to localhost.

MQTT_SERVER=192.168.1.23 npm run build

In this folder will be an index.html you can open locally or on the Pi's browser.

Run a local web server

For development, it's more practical to run a server on your localhost. This will compile and hot-reload code in realtime. It also has the benefit of checking your code and reporting errors when they happen.

MQTT_SERVER=192.168.1.23 npm run build

As with the build command, the MQTT_SERVER environment variable is optional and will default to localhost if omitted, but likely you want to develop from another machine and connect remotely to the openHAB server.

Deploy to your HestiaPi instance

After generating a distributable web app folder, you can deploy it to your HestiaPi instance using the following command

HESTIA=192.168.1.23 npm run deploy

⚠️ THIS WILL REPLACE YOUR HESTIAPI FILES! Make sure to make a backup if you want a rollback

Lint and fix files

If you need to check for errors without starting the local webserver, you can use the following command.

npm run lint

Extended features

This app was built using Vue.js and Vue CLI, although the code should be approachable to anyone with basic knowledge of modern javascript and component architecture. For extending and configuring the asset toolchain, see Configuration Reference.