New to Kendo UI for Angular? Start a free 30-day trial

Customizing Themes

Each Kendo UI theme package includes the source files of the theme. You can modify the source files and rebuild the theme as part of your build process. For example, you can change the theme colors, include CSS only for the components you use, or use specific theme colors to style your application. The theme source files are located in the scss folder of the theme package.

For a list of variables that you can modify in a theme, refer to the customization article about each theme:

To build a custom theme by using the theme variables, use one of the following options:

For visual editing and preview of the theme, use the ThemeBuilder application. It has a user-friendly interface where you can preview all components and experiment with the versatile color swatches.

Using the Build Process of the Application

If you use Angular 8, you have to upgrade to the latest version of the themes. For more information, refer to the article on keeping up to date.

With this setup, you can customize theme variables directly in your application. For example, you can change the default primary color from orange to pink with the following lines:

// styles.scss
$primary: #ff69b4;

@import "~@progress/kendo-theme-default/scss/dist/all.scss";

You can also customize individual components by overriding their variables:

// styles.scss
$panelbar-bg: #1b56b8;
$grid-bg: #1bb822;

@import "~@progress/kendo-theme-default/scss/panelbar/_index.scss";
@import "~@progress/kendo-theme-default/scss/grid/_index.scss";

Removing Themes from angular.json

The ng add schematics for the Kendo UI packages adds the precompiled CSS file to angular.json. When you use the SCSS files, you have to remove these references.

Supporting Legacy Browsers

The default Angular CLI configuration produces CSS that is not compatible with Internet Explorer 11. To provide support for Internet Explorer 9 to 11, add IE 9-11 in .browserslistsrc. For more information, refer to the official Angular documentation on browser compatibility and the Browserlist query syntax.

> 0.5%
last 2 versions
Firefox ESR
not dead
IE 9-11

Notes on Performance

While including the Kendo UI themes in the styles of your application is convenient, it adds up to 30 seconds to the build time because the themes are compiled on each build. To speed up the build process in Angular CLI v8, install the fibers package by running the npm install --save-dev fibers command.

Using the Build Process of the Themes

Each Kendo UI theme has a separate NPM package, for example, @progress/kendo-theme-default. However, the source code for all themes is located in the kendo-themes repository. It contains a build task that compiles the theme sources to CSS. To customize a theme, modify the source code of the theme, and use the build task to produce a CSS file for your application. This approach avoids the need to set up a build configuration when you compile SCSS, but may be harder to maintain, as the process has to be repeated each time a theme is updated.

Customizing Themes with Swatches

A swatch is a set of variables that customize the appearance of the theme.

  • Each swatch is placed in a separate file. A theme may contain multiple swatches.
  • Swatches are useful for creating multiple, persistent theme variations.
  • The .css output file can be shared across projects and requires no further processing.

To create a swatch:

  1. Clone the kendo-themes GitHub repository.
  2. (Windows only) Install the node-gyp prerequisites by running npm install --global --production windows-build-tools from an elevated PowerShell or, as Administrator, from the CMD.exe.
  3. Install the dependencies for all themes by running npm install && npx lerna bootstrap.
  4. Switch the working directory to packages/<THEME_NAME>.
  5. Create a SWATCH_NAME.scss swatch file in the scss/swatches folder.
  6. Type npm run sass:swatches or npm run dart:swatches to build the swatches for the theme.
  7. Include the compiled CSS swatch file in your project. You can find it under dist/SWATCH_NAME.css.

For example, in the Material theme, create a blue-pink-dark swatch with the following lines:

// Variables.
$primary-palette-name: blue;
$secondary-palette-name: pink;
$theme-type: dark;

// Import the theme file for the components you use.
@import "../panelbar/_index.scss";
@import "../grid/_index.scss";

// Alternatively, include all components.
// @import "../all.scss";

For the rest of the themes, the swatch should look like:

// Variables.
$primary: blue;
$secondary: pink;

// Import the theme file for the components you use.
@import "../panelbar/_index.scss";
@import "../grid/_index.scss";

// Alternatively, include all components.
// @import "../all.scss";

Customizing the Source Code

To create a custom theme by modifying the themes source code:

  1. Clone the kendo-themes GitHub repository.
  2. Install the dependencies for all themes with npm install && npx lerna bootstrap.
  3. Customize the theme variables in the packages/THEME_NAME/scss/_variables.scss files.
  4. Build the themes with the npm run sass or npm run dart command to create the customized version of the themes in the packages/THEME_NAME/dist/all.css file.
  5. After the build completes, use the compiled CSS.

Creating Custom Components Bundle

You might want to omit the styles for some components in the CSS output. To include only the styles that you need:

  1. Clone the kendo-themes GitHub repository.

  2. Install the dependencies for all themes with npm install && npx lerna bootstrap.

  3. Switch the working directory to packages/THEME_NAME.

  4. Create a CUSTOM_THEME.scss file in the scss folder. An example file could be custom.scss with the following lines:

    // Import the theme file for the components you use.
    @import "../panelbar/_index.scss";
    @import "../grid/_index.scss";
  5. Navigate to the theme folder and run gulp sass --file "scss/CUSTOM_THEME.scss" to build the file.

  6. Include the compiled CSS file in your project. You can find it under dist/CUSTOM_THEME.css.