Upgrading to 1.3.10
This is a feature and maintenance release, including bug fixes and library upgrades.
When upgrading to Hyvä Theme 1.3.10, always update the hyva-themes/magento2-theme-module package to its latest version. It is safe to update this module even if you are not updating the Default Theme to 1.3.10.
Notable News
PageBuilder Improvements
PageBuilder Background Image Lazy Loading
Lazy loading can now be toggled individually for each background image in PageBuilder.
Configure the default behavior at Hyvä > PageBuilder > Images > Enable lazy-loading by default for background images.
Important: Lazy loading is disabled by default. This prevents issues on sites where the theme-module is updated, but hyva-themes/magento2-default-theme is not, as the necessary JavaScript might be missing.
Once all Hyvä child themes are updated to magento2-default-theme 1.3.10 or newer, it is safe to enable lazy loading by default in the system configuration. Content managers can also enable it per-image in PageBuilder.
For new projects, consider enabling background image lazy loading by default from the start.
PageBuilder Image Dimensions and Lazy Loading
Always specify image dimensions to prevent CLS (Cumulative Layout Shift) issues. Enable lazy loading for images below the fold, and disable it for the LCP (Largest Contentful Paint) image.
Product Slider and Grid Admin Preview
Fixed an issue where product carousel and grid previews in PageBuilder were broken when using a Hyvä frontend theme.
Experimental Page Transitions
View Transitions, a new browser API, enables smooth and engaging animations during page transitions. This improves user experience by offering visual cues and reducing perceived page load times.
Disabled by default, enable it via system configuration: "Hyvä Themes > Experimental > Enable View Transitions".
Experimental Preloading Speculationrule Improvements
Default speculation rules now include cached pages without a .html suffix, explicitly excluding non-cached pages (e.g., customer account, cart). This also includes a minor bugfix for syntax improvements.
Skip CSS + JS Minification for Hyvä Theme Assets
Core Magento minification is now skipped for Hyvä theme assets. It offers no performance benefit for Hyvä themes, adds overhead, and can cause issues due to bugs.
Setting to Disable Homepage Demo Content
You can now disable homepage demo content via an admin configuration switch, eliminating the need for a child theme layout override.
Mollie Bundling
The Mollie payment method is now automatically installed as a Composer dependency.
Alpine.js Upgraded to 3.14.6
This minor version upgrade primarily includes bug fixes. See the Alpine.js release notes for details.
Tailwind CSS Upgraded to 3.4.13
This is likely the final release in the Tailwind 3.4 series.
Backward Incompatible Changes
Hard PageBuilder Dependency
The theme-module now depends on Magento\PageBuilder\Block\GoogleMapsApi.
If magento/module-page-builder is removed (e.g., via Composer's replace), static-content compilation will fail with the following error:
Fatal error: Uncaught Error: Class "Magento\PageBuilder\Block\GoogleMapsApi" not found in vendor/hyva-themes/magento2-theme-module/src/ViewModel/GoogleMapsApi.php:16
Solution: Either install PageBuilder and disable it using bin/magento module:disable, or provide a custom dummy class for the dependency.
Page JS Dependencies Only Available in Hyvä
The RegisterPageJsDependencies mechanism is now active exclusively for Hyvä themes. This change addresses reports of interference with email rendering when third-party modules utilize this feature.
Consequently, if a Luma-based theme is active (e.g., during email rendering), JS dependencies will no longer be rendered. While theoretically usable in Luma previously, the impact on existing sites is minimal due to Luma's reliance on RequireJS for JS dependency handling.
Changelogs
Access detailed changelogs in the codebase (CHANGELOG.md) or directly:
Tooling
For comprehensive upgrade guidance, consult the Hyvä Theme upgrade documentation.