Customizing your application using theme variables

Settings for a theme are managed by theme variables that are set in the theme.scss.json file.

Before you begin

This procedure assumes you are comfortable updating theme parts and themes. For the basic principles behind themes and theme parts, see How customization works. For instructions about adding and modifying themes and theme parts, see Working with themes. For information about the underlying GBC infrastructure and its components, see Theme reference.

  1. Identify the theme part you plan to update. If you are creating a new theme part, prepare the directory.
  2. In the theme part, open the theme.scss.json file in a text editor.
  3. Modify an existing theme variable value or add a new theme variable and value.
    For more information about the json file, see theme.scss.json file. For a full list of theme variables, see Theme variables reference.
  4. If you created a new theme part, add it to one or more themes.
  5. Save your changes and rebuild your customization using gbc build: 
    $ gbc build --customization customization-project-dir
  6. Test that your changes work as expected.
    Tip:

    You may need to use CTRL + F5 to clear the browser cache before you see your changes.

    If your tests do not behave as expected, ensure you are using your newly-built custom GBC. Depending on your development environment, you may need to package and deploy a custom GBC client. For information on which customization and theme you are using, see Selecting customizations and themes.