Upgrading to 1.2.0
Hyvä 1.2.0 is currently available only as BETA release: 1.2.0-beta2
Run the following command to upgrade to the latest beta release:
Hyvä 1.2.0 switches both of the fundamental libraries Alpine.js and Tailwind CSS used by the default-theme from version 2 to version 3.
Because of this, some changes need to be made to existing themes.
A Hyvä theme can use either use Alpine.js v2 OR v3. It is not possible to use both at the same time.
If stores use multiple themes, they can be migrated one at a time.
hyva-themes/magento2-theme-module in version 1.2.0 woks with both Alpine.js v2 and v3.
So even if not updating a theme to 1.2.0, it should always be safe to update
Hyva_Theme module to the latest version.
Hyvä 1.2.x requires GraphQL Cart >= 1.0.4
If you are using the
hyva-themes/magento2-graphql-cart module, upgrade it to 1.0.4 first, so the composer dependency can be satisfied:
To upgrade an existing theme from v2 to v3, Hyvä provides migration scripts, that will get you most of the way.
You will have to test your theme completely and make additional changes as needed.
The upgrade script and instructions to use it can be found at: https://gitlab.hyva.io/hyva-themes/upgrade-helpers
bin/hyva-1.2.0-tailwind-and-alpine.js will migrate both Alpine and Tailwind to v3.
However, it is also possible to only upgrade one or the other, or go step by step.
To do so, the scripts
src/alpine-v2-to-v3/v2-to-v3.js (README) and
src/tailwind-v2-to-v3/v2-to-v3.js (README) can be used.
Please refer to the readme files provided with the scripts for more information!
Detailed instructions what needs to be done to migrate Alpine and Tailwind from version 2 to version 3 can be found on the respective sites:
Changelogs are available from the CHANGELOG.md in the codebase, or here: