Upgrading to 1.3.7
Release 1.3.7 brings performance enhancements, bug fixes, new features, and improved accessibility.
Important: When updating to Hyvä Theme 1.3.7, always update the hyva-themes/magento2-theme-module (the Hyva_Theme module) to its latest version. This module can also be safely updated independently, even if you are not updating the Default Theme itself to 1.3.7.
Notable News
New Alpine.js x-defer Directive
A new custom Alpine directive, x-defer, is introduced to reduce main thread blocking time and enhance Core Web Vitals. For details, see the x-defer documentation.
Automatic x-defer Injection
The hyva-themes/magento2-theme-module now automatically injects the x-defer directive into specific Alpine components. This improves user experience for themes based on older Hyvä versions simply by upgrading the module to 1.3.7+. Injection rules are based on CSS selectors and are configurable in the backend.
Important: Review customized themes to ensure components with private-content-loaded event listeners are not accidentally deferred. More information on defer rule injection is available in the x-defer documentation.
Experimental Prerender Speculation Rules
Hyvä 1.3.7 introduces an experimental implementation of a new browser API that pre-renders pages users are likely to visit next, significantly improving user experience. Enable it via system configuration: Hyvä Themes > Experimental > Experimental Features > Enable Preloading Speculation Rules.
Learn more about this browser API: developer.chrome.com/docs/web-platform/prerender-pages and nitropack.io/blog/post/speculation-rules-api.
Compatibility with Magento 2.4.7
Hyvä 1.3.7 is compatible with Magento 2.4.7. Changes primarily address the new Magento_OrderCancellationUi module. Note that current changes are based on 2.4.7-beta3, so minor adjustments might occur with the final Magento release.
New Translated Phrases
The following phrase has been added to the translation dictionary:
New Dependency: hyva-themes/magento2-order-cancellation-webapi
Magento 2.4.7's order cancellation feature is GraphQL-only by default. To reduce future GraphQL reliance in Hyvä, this new dependency provides a REST API for the compatibility module.
Reset-Theme Dependency 1.1.6
The reset-theme dependency is updated to version 1.1.6, incorporating new layout XML resets for the Magento_OrderCancellationUi module introduced in Magento 2.4.7.
Changelogs
Detailed changelogs are available in the codebase's CHANGELOG.md, or via these links:
Tooling
For comprehensive upgrade instructions, please consult the Hyvä Theme upgrade documentation.