Hyva Compatibility Issues with Amasty Extensions: Troubleshooting Guide

I have some Hyva-related compatibility issues, what should I check?

If you are experiencing issues with our extensions in conjunction with the Hyvä theme, please check the points below and ensure that they have been performed correctly.

Step 1. To ensure a smooth experience with our extensions and the Hyvä theme, it is crucial to use the most recent version of Hyvä. If needed, please update the theme following the official Hyvä instructions.

Step 2. Verify that you have installed the correct compatibility package. It is essential to install the submodule developed specifically by Amasty, rather than the one provided by Hyvä. Also, some of our modules require the installation of GraphQl compatibility add-ons for Hyvä compatibility to work. Check the list of Amasty Hyvä packages and if GraphQl package is required here.

Additionally, make sure that you are utilizing the latest version of the Amasty package. The current version of the Hyvä package installed on your Magento can be found in its composer.json file located at:
⇾ Magento-root-directory/vendor/amasty/[hyva-package-name] - for Hyvä packages installed via Composer;
⇾ Magento-root-directory/app/code/Amasty/[HyvaPackageName] - for Hyvä packages installed manually.

Example of the composer.json file for the Custom Form Compatibility with Hyvä submodule:



Next, compare it with the latest available version of the Hyvä package. To determine the most recent release, navigate to the product page of the main extension on amasty.com and open the Change Log tab. There you will find the Hyvä Compatibility section with the latest releases: 



If you need to update the submodule, follow these instructions: How to update an Amasty extension?

Step 3. Make sure that you have executed the following commands to regenerate styles after installing the Amasty Hyvä package. First the following commands need to be run:

bin/magento hyva:config:generate -f
cd vendor/hyva-themes/magento2-default-theme/web/tailwind

Then run one of the following commands based on what version of Hyvä theme you have. This command should be run on Hyvä versions up to 1.3.22:

npm run build-prod

For Hyvä 1.4.0 or newer, use the command below:

npm run build

Notes
If you need to learn how to find Hyvä theme version installed in your instance, you may refer to our article : How to check what version of Hyva theme I'm using?

Step 4. Kindly check if the built-in Magento minification and bundling is disabled. Magento optimization can break styles and functionality on the Hyvä frontend. Additionally, Hyvä officially recommends switching off the built-in minification and bundling of HTML, CSS and JS. You may disable the built-in minification with the following commands: 

bin/magento config:set dev/template/minify_html 0
bin/magento config:set dev/js/merge_files 0
bin/magento config:set dev/js/enable_js_bundling 0
bin/magento config:set dev/js/minify_files 0
bin/magento config:set dev/js/move_script_to_bottom 0
bin/magento config:set dev/css/merge_css_files 0
bin/magento config:set dev/css/minify_files 0

For more details, please, refer to the following official Hyvä documentation.

If you continue to experience issues, please feel free to reach out to us without hesitation. We will investigate further to ensure that the modules operate seamlessly on your Magento.