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

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ä. Check the list of Amasty Hyvä packages 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:

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

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.