Upgrading to 1.1.14

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

Version 1.1.14 is a feature release with no backward compatibility breaking changes. Refer to the changelog below for details.

Manual updates

To enable Tailwind CSS and config merging from modules in your theme after this upgrade, follow these manual steps:

1. In your theme's web/tailwind directory, install the required npm module:

   npm install @hyva-themes/hyva-modules
   

2. Import the module in your theme's tailwind.config.js file:

   const hyvaModules = require('@hyva-themes/hyva-modules');
   

3. Wrap module.exports in hyvaModules.mergeTailwindConfig:

   module.exports = hyvaModules.mergeTailwindConfig({
       // theme tailwind config here ...
   })
   

4. Import the module in your theme's postcss.config.js file:

   const { postcssImportHyvaModules } = require("@hyva-themes/hyva-modules");
   

5. Add postcssImportHyvaModules to module.exports before the postcss-import plugin:

   const { postcssImportHyvaModules } = require("@hyva-themes/hyva-modules");
   
   module.exports = {
       plugins: [
           postcssImportHyvaModules,
           require('postcss-import'),
           // other plugins
       ]
   }
   

6. Run bin/magento hyva:config:generate to generate hyva-themes.json.

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

Noteworthy Changes

The node module for the PostCSS plugin and Tailwind config merge function is available at github.com/hyva-themes/hyva-modules-tailwind-js.

Changelogs

View changelogs in the CHANGELOG.md file in the codebase, or via these links:

• Default Theme Changelog
• Theme Module Changelog

Upgrade Tooling

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