This page is relevant to you when you want to create your own theme for Blueriq using The Angular framework for Blueriq |
The Blueriq Material Theme can be used with Blueriq 10.x and onward. |
This will explain on how to get your own material theme up and running so you can start create your own theme based on this kickstarter
The following steps should be taken to get the Angular based Blueriq Material Theme running
yarn.lock
file that is distributed with the kickstarter theme (see yarn.lock
section below)The next step would be to customize it to your liking. Take a look at the theme folder and read the 'THEMING.md' to get the best practice on how to do so.
yarn.lock
fileThe yarn.lock
file that is distributed with the kickstarter theme is used by Blueriq's CI servers. It references Blueriq's internal Artifactory server, as the CI servers cannot connect to the internet directly.
Therefore, when initially using the kickstarter project, you should remove the yarn.lock file before performing `yarn install`. You should check the resulting new yarn.lock
file into your version control system.
Angular apps require a base href in order to find the proper resources. More information can be found in the Angular documentation on deployment.
The Blueriq Material theme contains some inline javascript code to determine the base href in case the theme is served from the Runtime itself, because the URL can differ per customer and per server. If you know the URL on which the Angular application runs beforehand, you are encouraged to remove the inline javascript code from index.html and configure the base_href statically, by including a hard coded <base href="/path/to/your/app">
tag or by specifying in the base href in angular.json
.
For more information on this subject please read the following: Angular and Deploying the theme