Table of Contents & Menu
Navigation

Upgrading to 1.1.15

When upgrading to Hyvä Theme 1.1.15, always update the hyva-themes/magento2-theme-module to its latest version. It's safe to update the Hyva_Theme module (package hyva-themes/magento2-theme-module) even if you're not updating the Default Theme to 1.1.15.

Backward incompatible changes

New Cart Page

Version 1.1.15 replaces the GraphQL-based cart with a server-side rendered cart page.

To retain the GraphQL cart, install the hyva-themes/magento2-graphql-cart extension:

composer require hyva-themes/magento2-graphql-cart

After installation, the GraphQL cart is restored. You can switch between cart types in the system configuration: Hyva Themes > Cart Page > General Settings > Cart Selection.

All other changes (excluding the cart) are backward compatible and can be merged into existing themes after updating the theme-module to 1.1.15.

Noteworthy changes

Automatic hyva-themes.json updates

This release introduces automatic regeneration of app/etc/hyva-themes.json when any of the following commands enable or disable a module:

  • bin/magento module:enable
  • bin/magento module:disable
  • bin/magento setup:upgrade

This eliminates the need to manually run bin/magento hyva:config:generate.

Automatic inclusion of the theme-module in the tailwind content path

After upgrading hyva-themes/magento2-theme-module, it automatically registers itself for theme CSS generation using the tailwind.config.js merging feature (introduced in 1.1.14).

After upgrading the magento2-theme-module, run bin/magento hyva:config:generate once. You can then optionally remove the hardcoded path to the theme module from your theme's Tailwind content configurations.

For details on Tailwind config merging, refer to the compatibility module documentation for Tailwind Config and Tailwind CSS merging.

Changelogs

Changelogs are available in the codebase's CHANGELOG.md or via these links:

Tooling

Refer to the Hyvä Theme upgrade documentation for general upgrade guidance.