Publishing your UIs

Once you have built and tested your interfacs, you need to publish them to Lucy in order to make them available in portals.

Publishing is a two-step process:

1. Prepare your bundle.json file with the required metadata.

2. Uploading your changes to Lucy

Preparing your bundle

There is a json file called bundle.json in the root directory of your project. Here, you need to fill in metaata about the components you want to publish. Look at the bundle configuration page for information on how to fill this.

Uploading your changes

Uploading your changes is straightforward. You need to use the lucy-xp tool to upload your changes to your Lucy server.

$ npx lucy-xp upload dist/main.js bundle.json --lucy-apikey "SC:test:124" --lucy-url "https://myserver.iviva.cloud"

The parameters to the lucy-xp command are:

• upload - this is the command to upload your changes to a Lucy server

• dist/main.js - this is the path to the final output javascript file that contains all of your code. This is generated by webpack.

• bundle.json - the path to your bundle.json file

• --lucy-apikey <apikey> - The api key to use to upload changes to the Lucy server. You need to generate an API Key on the Lucy server and use that here

• --lucy-url <url> - The full url to your Lucy server

You can update an existing bundle on the server by simply re-uploading it. As long as the bundle id hasn't changed it will replace the existing bundle.