Yireo ThemeByRoute

yireo/magento2-theme-by-route

Loads a specific theme per route based on an app/etc/theme-by-route.json file, with advanced per-website and per-store scope rules for fine-grained theme selection.

No errors foundPHPStan level 3Build passingSemVer violations (83% compliant)
Supported Magento versions
2.4.9
License
OSL-3.0
Categories
Developer Tools

513 installs★ 2 stars15 downloads/monthLatest: v1.1.2Released 2025-12-01

composer require yireo/magento2-theme-by-route

README

Reproduced from the package’s own README, under its own license, as of 2026-10-31. Links and images point back at the source repository.

Yireo_ThemeByRoute

Magento version PHP version License Latest Version

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"
    ]
  }
]

Current status

Static Tests Unit Tests Integration Tests Playwright DI Compilation

Links

More from yireo

  • Googletagmanager2

    Implements Google Tag Manager in Magento 2. Supports GA4, click events, and offers extensibility.

  • NextGenImages

    Magento 2 module to add next-gen image support to Magento 2.

  • Whoops

    Adds Whoops error handling to Magento 2 for improved debugging. Provides detailed error reports to assist developers in identifying and resolving issues.

Similar modules

  • Optimize Cache Size

    Reduces cache keys by removing product/category specific layout handles. Improves performance by decreasing cache size and average Redis TTL.

  • Rtl

    Adds RTL (right-to-left) support to Magento themes and modules. It provides CSS classes and LESS mixins for easier styling of RTL layouts.

  • Webapi Logs

    Logs and analyzes all REST API calls made to your Magento store. Provides detailed request and response information for debugging and monitoring.

← All packages from yireo