The Hyvä 1.4.1 version is designed specifically to give v1.4 branch users a smooth, high-security finish that keeps your store competitive without the friction of a major version leap.
Learn more about this version in detail here.
Key Highlights of the Hyvä Theme 1.4.1 Release
1. Fixed Speculation Rules (Store Code Support)
One of Hyvä’s most powerful features is the Speculation Rules API, which allows the browser to pre-render pages in the background before a user even clicks.
In previous versions, stores using store codes in the URL (e.g., domain.com/en/) encountered issues where pre-rendering failed.
The v1.4.1 now fully recognizes store code paths.
This is a major win for international and multi-language storefronts, ensuring “instant navigation” works perfectly regardless of the URL structure.
2. Gallery & PLP Item Enhancements
The Product List Page (PLP) and product galleries received quality-of-life updates to ensure a smoother shopping journey:
- Resolved an issue where the image gallery wouldn’t correctly update for individual items on the list page when switching swatches.
- Fixed bugs affecting the gallery’s fullscreen mode, providing a more reliable and immersive viewing experience for mobile and desktop users.
3. Accessibility (A11y) & UX Refinement
In line with modern WCAG standards and SEO best practices, v1.4.1 improves how users with disabilities interact with your store.
- Improved focus handling in the product gallery to ensure keyboard users can navigate images without getting “trapped.”
- Enhanced ARIA support for gallery thumbnails, ensuring screen readers accurately describe the content to visually impaired customers.
4. New Design Component: input-group
Hyvä has introduced the input-group CSS component. This allows developers to bundle elements together with minimal custom Tailwind utility classes.
This is perfect for Newsletter Subscription boxes or Header Search bars, where an input field and a button need to appear as a single, unified element.
5. Developer Experience (DX) & Debugging
Hyvä continues to prioritize the developer’s workflow by making the “under the hood” logic more transparent:
Debugging Alpine.js is now significantly easier. By adding source URLs, you can debug JavaScript directly in browser dev tools as if you were working with standalone.js files.
The hyva.config.json file now includes detailed comments, clarifying exactly how to utilize this file for complex theme configurations.
How to Upgrade to Hyvä Theme 1.4.1 Version
Before upgrading, ensure your environment meets the following requirements:
- Compatible with Magento 2.4.x.
- Requires hyva-themes/magento2-theme-module version 1.6.5 or higher.
- A full CSS rebuild is recommended to utilize new components.
To bring these features to your store, run the following command in your terminal:
composer update hyva-themes/magento2-default-theme
Note: After updating, remember to run your production build for Tailwind CSS to activate the new input-group styles and accessibility fixes.
Version 1.4.1 reinforces Hyvä’s commitment to providing a stable, open-source framework that is as easy to build as it is fast to browse.
For high-performance Magento stores, these improvements to speculation rules and debugging tools are vital for maintaining a competitive edge.
