Theming#

To develop our theme, we can use Semantic UI variables and theme overrides to achieve our theme, or we can use Volto's custom.overrides. We also can mix elements of both as needed. There is no right or wrong way of doing it, and we will be using the Semantic UI theming engine in both cases.

Theming engine diagram

Basic font family#

We will use Semantic UI variables for customizing the font, as it's a valuable feature. Create a file in the following path theme/globals/site.variables.

Now you need to restart Volto to make Volto aware of the new file. From now on changes in this file will be automatically applied upon save and you will see the results in your browser.

Edit the new file and add this:

@fontName: 'Roboto';

You can set it to any Google font available, and the online version of the font will be used. You can also set other variables concerning the font used, such as the sizes available. In case you want to use more than one font or a font that is self-hosted, you should define it as usual in CSS and set the variable importGoogleFonts appropriately. As Roboto is Google Font we will set

@importGoogleFonts: true;

Tip

You can find the list with the global Semantic UI variables available in omelette/theme/themes/default/globals/site.variables.

custom.overrides#

Create a file named theme/extras/custom.overrides which will contain all the CSS concerning our local theme. This is a file containing LESS declarations. It's loaded more quickly than the theme ones, because it's outside the theme. You should restart Volto to make Volto aware of the new file.