In order to be valid, the root folder of a theme must contain a desc.json file. If not, it won't be shown when refreshing the available themes.
Creating a theme
In order to create a theme, we recommend to copy one of the existing theme folders (either Blue or Black theme, do not select the Green one because the themes are inherited from it, and it might cause issues with future updates) from Portal/Newired/themes
A theme is defined by the following file structure
theme-id/
less/
variables.less
bubble.less
launcher.less
_feedback.less
_fonts.less
...
fonts/
*.ttf, *.woff, etc.
desc.json
preview.png
Once you have a copy, you can rename your new theme folder and then edit the .less files contained in the theme folder, here's a list of the files you can edit:
| desc.json | Metadata of the theme - theme name, author, version, ... |
| preview.png | Preview image that shows how the theme looks like on the portal and on the editor |
| bubble.less | Entry point for the styles of the bubble |
| launcher.less | Entry point for the styles of the launcher |
| variables.less | Definition of variables that are used to customize the theme |
| _bubble.less | Style definition of the bubble module |
| _custom.less | Custom style definition - used when the variables provided are not sufficient |
| _feedback.less | Style definition of the feedback module |
| _fonts.less | Definition of the fonts that are used in the theme |
| _global.less | Basic style definition |
| _handle.less | Style definition of the handle module |
| _progress.less | Style definition of the progress module |
| _spotlight.less | Style definition of the spotlight module |
| _window.less | Style definition of the launcher module - Journey list, settings, ... |
To adjust the basic properties (parameters) of a theme, you can change values in "variables.less" file that we are providing
To adjust another part of the theme when the variables provided by us are not sufficient, you can modify "_custom.less" file (recommended) or you can modify other .less modules (not recommended but possible)
Keep in mind that the additional themes will be inherited from the default one (Newired Green), therefore we suggest not to delete it because it will break the other themes.
Modifying a theme
To modify a theme, access its root folder inside the portal server (you can find it in PORTAL FOLDER/themes). From here, you can edit all the .less files in order to edit the theme as you want.
Then, access the Portal and click on the Addons button.
Scroll down until you find the Themes section, and click on the Reload button you find there to apply your changes.
If your changes have broken the theme, it simply won't show among the available themes and a warning box will pop up.
If you have modified the currently used theme and the changes have broken it, Newired default theme will be used and a “missing theme” indication in the Site Settings of both the Portal and the Editor will appear. If you restore the broken used theme and press Reload, it will be automatically reset as selected theme.
