Installation & Configuration
The Hyvä Checkout is a stand-alone commercial product, currently available to Hyvä Themes licensees only.
- Magento Open Source or Adobe Commerce 2.4.3 or higher
- PHP 7.4 or newer
- Hyvä Themes 1.1.16 or newer
Tailwind JIT only
The deprecated Tailwind AOT mode is not supported, the JIT mode that is available since Tailwind v2 has to be used with the Hyvä Checkout.
Hyvä Checkout can be installed through your Hyvä packagist.com license key.
Run the command
Disable the Magento HTML minification in the configuration setting
Advanced > Developer > Template Settings > Minify Html, or run
HTML minification can be enabled since v1.1.6, even though we still recommend it being disabled.
Run the command
Execute tailwind to generate the styles for the checkout, replacing
vendor/hyva-themes/magento2-default-theme/web/tailwind/with the path to your theme's
The admin configuration can be found at
Stores > Configuration > Hyvä Themes > Checkout.
In the General section, the setting for "Checkout" defaults to "Magento Luma (original)".
To use the Hyvä Checkout, you need to change the selection to "Hyvä Default" and save the configuration.
If you create custom checkouts based on Hyvä Checkout, they will also be listed as options.
Mobile Checkout configuration
If the optional "Mobile" checkout is enabled in the Hyvä Checkout system configuration, it will be used when a visitor's user agent matches a known mobile device.
This allows presenting a different checkout experience that is optimized for mobile use.
For example, multiple steps can provide a better customer experience on a phone, while a one-page checkout can work better for visitors using a desktop browser.
The regular expression for matching mobile user agents can be customized in the
"Hyvä Themes > Checkout > Developer" section.
After changing any setting, be sure to flush the cache.
For now, please explore the other Hyvä Checkout configuration options on your own - most will be rather self-explanatory.
All configuration options will be added to the documentation over time.