Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Optimize Build Performance of CSS and JavaScript Assets

There are two factors that affect the build performance of CSS and JavaScript asset the most, JavaScript compilation with Babel and the number of enabled layout themes.

JavaScript Compilation with Babel

Babel processes JavaScript to make it compatible with older browsers. Because there are many asset files to process, resource consumption is high.

If you have to support older version of browsers, consider enabling Babel for the project by adding the below configuration to the config/config.yml file:

config/config.yml

oro_asset:
    with_babel: true

Enabled Layout Themes

Layout themes in OroCommerce can extend each other, but to avoid side effects during the build, every layout theme in the OroCommerce application is fully isolated. Therefore, the build time and resource consumption directly depend on the number of enabled themes. All the available themes are enabled out of the box, including the three default ones (blank, default, and custom). In most cases, the default themes are unnecessary in a custom application with its own themes and custom CSS and JavaScript.

To build only the themes that are in use and disable the rest, provide the list of enabled themes by adding the following configuration to the config/config.yml file:

config/config.yml

oro_layout:
    enabled_themes: [acme_default_theme, custom_theme_for_german_website]