What Is hyva-themes.json?

You will find this file under app/etc and this file is a Hyvä compatibility mapping file used to register Hyvä-compatible module sources—specifically for the Hyvä Checkout and Admin modules.

This files looks like

{
    "extensions": [
        {
            "src": "vendor\/hyva-themes\/magento2-theme-module\/src"
        }
    ]
}

 

What It Does:

This file tells Hyvä to:

  • Look into the listed src directories for Hyvä-compatible modules or UI components.

  • Register and include them when generating view models, templates, or layout updates.

When you run Hyvä commands like:

 
bin/magento hyva:config:generate
 
bin/magento hyva:compatibility:check
 

— this JSON file tells Magento which additional directories to scan for compatibility modules.

 

 

Recommendation

You don't need to modify this manually unless you're:

  • Adding a new third-party module with Hyvä support.

  • Writing your own compatibility module.

  • Using a non-default directory structure for Hyvä sources.