Upgrading to 1.3.0

Version 1.3.0 is a feature release focused on accessibility.

When upgrading to Hyvä Theme 1.3.0, always update the hyva-themes/magento2-theme-module to its latest version. This module update is safe even if you are not updating the Default Theme itself.

Before Upgrading

This release introduces significant accessibility changes. We strongly recommend familiarizing yourself with accessibility best practices before upgrading. Start by reviewing our guide on customizing templates for accessibility and the three-part Hyvä Blog series on accessibility by Anna Karoń from Snowdog.

Tooling

These tools can significantly speed up your upgrade process:

Making Existing Custom Hyvä Themes Accessible

Due to accessibility requirements, the DOM structure of many Hyvä templates has changed. These changes are not automatically applied to existing custom themes and require manual adjustments.

We recommend testing your theme using the tools from accessibility Blog post #2 and applying improvements incrementally. Repeat this process after every customization to maintain accessibility.

New tailwind.config.js Entry

After upgrading, add the a11y key to theme.extend.minHeight in your theme's web/tailwind/tailwind.config.js file. This value sets the minimum height for textarea inputs. Use the tailwind.config.js from hyva-themes/magento2-default-theme/web/tailwind/ as a reference:

      minHeight: {
        14: spacing["14"],
        'a11y': '44px',
        'screen-25': '25vh',
        'screen-50': '50vh',
        'screen-75': '75vh'
      },

Remember to regenerate your styles after adding this value.

Backward Incompatible Changes

DOM Selector Changes

Accessibility requirements led to DOM structure changes in many templates. This may break end-to-end tests (e.g., Elgentos Cypress Magento2) and third-party modules relying on specific DOM selectors. Adjust your front-end tests and thoroughly test all front-end customizations after upgrading.

New Localization Phrases

This release introduces many new translation phrases for accessibility labels, primarily for assistive technologies like screen readers and voice control. Ensure these phrases are translated when updating an existing theme. Hyvä language packs will be updated for 1.3.0 shortly after release.

Changed Phrase

The phrase Sku has been updated to match Magento core's SKU and is no longer included in the Hyvä i18n/en_US.csv file.

Added Phrases

Unusual Wording

Some phrases may seem unusual, but their wording is optimized for voice input interaction. For example, "Edit Address - billing default" is more usable for voice control than "Edit default billing address." Keep this in mind when adding new translations.

The following phrases have been added to i18n/en_US.csv compared to version 1.2.6:

%0 of %1 products in cart displayed
%1 filter options
"%1 filter, %2 available products"
"%1 filter, 1 available product"
%1 options
%1 rating. %2 out of %3 stars
%1 rating. %2 out of %3 stars. Click to go to reviews.
%1 stars
1 star
Add %1 to Cart
Add to Cart %1
Add to cart selected products from list
Back to main categories
Carousel
Carousel %1
Cart is empty
Click to view image in fullscreen
Close fullscreen
Close menu
Close message
Close minicart
Confirm password hidden
Display slide %1
Edit %1
Edit Address - billing default
Edit Address - shipping default
Edit contact information
Edit newsletters
"Edit product ""%0"""
Filter %1 %2
Final product price 
Gallery modal fullscreen
Go to Home page
Go to Wish List page
Hyva twitter profile
Item %1
Main image
Main menu
Navigating through the elements of the carousel is possible using the tab key. You can skip the carousel or go straight to carousel navigation using the skip links.
Next slide
Open %1 subcategories
Open menu
Password hidden
Password shown
Press to go to carousel navigation
Press to skip carousel
Previous slide
"Product ""%0"""
"Product ""%1"" is not salable"
Product filters
Product list
Products view mode
Products view mode - %1
Remove active %1 filter: %2
Remove item %1
"Remove product ""%0"" from cart"
"Remove product ""%1"" from My Wish List"
"Remove product ""%1"" from the comparison"
"Select product ""%1"" to reorder"
Show items per page
Show submenu for %1 category
Site navigation
Site navigation links
Skip to product list
Store logo
Subcategories
Toggle minicart
Toggle search form
"Unable to find the SVG icon ""%1"
View all orders
View all recent orders
View cart
View order
confirm password shown
filter
form appears when field is selected
opens in new window

Changelogs

View the changelogs in the codebase (CHANGELOG.md) or via these links:

General Upgrade Information

For general upgrade guidance, refer to the main Hyvä Theme upgrade documentation.