Installation

To upgrade a Magento Luma theme to a Loki Theme, the LokiTheme_LumaComponents module and its dependencies need to be installed. Here are the steps.

composer require loki-theme/magento2-luma-components
bin/magento module:enable LokiTheme_LumaComponents Loki_Base Loki_CssUtils

As you can see, the LokiTheme_LumaComponents module has a dependency with Loki_Base and Loki_CssUtils which might be useful as well, outside of the scope of Loki Theme (as in: upgrading a Luma theme).

At this moment, nothing has changed yet! To upgrade a given Luma theme, you will need to configure Loki Theme to be applied to that theme.

Theme configuration

Within the Magento Admin Panel, navigate to Stores > Configuration and then to Loki Theme > Generic Settings > Applied Themes. Select the theme that you want to apply Loki to and then save the configuration.

Your configured theme should now be faster. Perhaps things are broken, but these pages guide you into fixing that.

Applying Loki Theme to specific frontend themes
Applying Loki Theme to specific frontend themes

Migrating to a faster theme, page by page

You might not want to apply Loki Theme to all pages at once, simply because not all removed JavaScript on all pages is properly replaced yet. Instead, you might want to create a new child theme of your own Luma theme and then apply that child theme to specific pages that are ready. We've got a doc for that.

See: Partially applying themes

Last modified: September 16, 2025