Yireo_ThemeByRoute

Magento 2 module to allow a file app/etc/theme-by-route.json to determine which theme needs to be loaded for which route.

Installation

composer require yireo/magento2-theme-by-route
bin/magento module:enable Yireo_ThemeByRoute

Configuration

Create a file app/etc/theme-by-route.json similar to the following:

{
  "Loki/luma": [
    "cms/index/index"
  ]
}

Now, the Loki/luma theme is applied to all pages.

If you want to control under which circumstances which theme is applied, there is an advanced syntax as well:

[
  {
    "scope_type": "website",
    "scope_code": "default",
    "theme": "Loki/luma",
    "pages": [
      "cms/index/index"
    ]
  }
]

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[Unreleased]

[1.1.2] - 01 December 2025

Fixed

• Add enabled config option

[1.1.1] - 22 October 2025

Fixed

• Allow psr/log 1 and 2 besides 3

[1.1.0] - 22 October 2025

Added

• Add advanced syntax

[1.0.3] - 30 September 2025

Fixed

• Fix matching of request URI

[1.0.2] - 30 September 2025

Fixed

• Also do a direct match on URLs

[1.0.1] - 10 September 2025

Fixed

• Change JSON filename to app/etc/theme-by-route.json
• Better README

[1.0.0] - 09 September 2025

Added

• Copy generic CI/CD files
• Adding all files to git via Yireo Command
• Initial release