Checkout Hyva
v1.2.5
Checkout Hyva
- Updates and support included for 12 months
- License key delivered immediately by email
- 30-day money-back guarantee
- Full documentation included
- Compatible with Hyvä themes
- Composer-ready installation
Checkout for Hyvä
A thin compatibility layer that makes wimakeit/module-checkout work cleanly on Hyvä-themed stores. Install it alongside the base checkout module and the customised one-page checkout — with its styles, payment-method icons and success page — renders correctly on Hyvä, picked up by the Tailwind build, with no manual workaround.
The base wimakeit/module-checkout stays theme-agnostic so it can ship to Luma and Breeze stores. Hyvä's <head> renderer, however, drops the rel="stylesheet" attribute from layout-declared <css> directives, which silently strips the checkout's styling. This companion module solves that — and only that — without polluting the base module with Hyvä-specific code.
Who it's for
- Hyvä-themed Magento 2 / Mage-OS stores already running (or planning to run)
wimakeit/module-checkout - Merchants migrating from Luma to Hyvä who want their customised checkout to follow without rework
- Agencies maintaining mixed Luma + Hyvä fleets who prefer a separate compatibility module over forked theme code
Key benefits
- Proper stylesheet delivery on Hyvä — emits a real
<link rel="stylesheet">forcheckout.cssandsuccess.cssso the checkout looks the way it should, not a bare HTML fallback. - Self-contained compiled CSS — ships its own
view/frontend/web/css/checkout.cssandsuccess.css, compiled from the base module's LESS partials. No reliance on the base module's frontend assets. - Tailwind build integration — registers both
module-checkoutandmodule-checkout-hyvatemplate paths with Hyvä's Tailwind purge config via thehyva_config_generate_beforeevent. Runbin/magento hyva:config:generateand your theme build picks up every utility class. - Payment-method icons on Hyvä — the icon resolver and CSS rules introduced in
wimakeit/module-checkout1.7 reach Hyvä unchanged through this layer. - No base-module pollution — Luma and Breeze stores keep a clean base module. Hyvä stores opt in to this companion only when they need it.
- Drop-in upgrade path — bumping the base checkout to a new minor version is matched by bumping this module; nothing else changes in your theme.
Compatibility
- Magento 2.4.x / Mage-OS equivalent
- PHP 8.1, 8.2, 8.3
- Requires
wimakeit/module-checkout^1.7 - Requires
hyva-themes/magento2-theme-module^1.3 - Only install on Hyvä-themed sites — Luma and Breeze sites do not need it
Install this module via Composer. Make sure your auth.json is configured with your Wimakeit credentials.
$ composer require wimakeit/module-checkout-hyva:^1.2.5
$ bin/magento setup:upgrade
$ bin/magento setup:di:compileInstallation notes
The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.
When to install
Only install this module on Hyvä-themed sites. Luma and Breeze stores do not need it — the base wimakeit/module-checkout already ships everything they need.
Required dependencies
| Package | Minimum version |
|---|---|
wimakeit/module-checkout | ^1.7 |
hyva-themes/magento2-theme-module | ^1.3 |
Composer pulls them automatically as long as the Wimakeit registry is declared in your project's composer.json and Hyvä is already installed.
Admin configuration
This module has no admin configuration of its own. It inherits every setting from wimakeit/module-checkout — go to Stores → Configuration → Wimakeit → Checkout to manage the underlying checkout behaviour.
Install flow
composer require wimakeit/module-checkout-hyva
bin/magento module:enable Wimakeit_CheckoutHyva
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento hyva:config:generate
cd app/design/frontend/<Vendor>/<theme>/web/tailwind
npm run build-prod
bin/magento cache:flush
The hyva:config:generate step is essential — it lets Hyvä's Tailwind build see both this module's templates and the base wimakeit/module-checkout templates, so every utility class used in those .phtml files survives the purge.
Upgrade flow (when bumping the base checkout)
When wimakeit/module-checkout ships a new minor (e.g. 1.7 → 1.8) with new LESS partials or templates:
# Inside this module's directory
npm run build:css # Recompile checkout.css / success.css from the base module's partials
# Back in the Magento project
bin/magento hyva:config:generate
cd app/design/frontend/<Vendor>/<theme>/web/tailwind && npm run build-prod
bin/magento cache:flush
How it integrates with Hyvä
- A custom block is added to
<head>oncheckout_index_indexandcheckout_onepage_success, emitting a proper<link rel="stylesheet">(Hyvä's native renderer drops therelattribute on layout-declared<css>entries). - An observer on
hyva_config_generate_beforeregisters this module andwimakeit/module-checkoutwith Hyvä's Tailwind purge config. view/frontend/tailwind/module.csscarries@sourcedirectives covering both modules' templates so any Tailwind class added in.phtmlfiles survives the build.
- Version
- v1.2.5
- Support
- 12 months
- Last updated
- Aug 28, 2026
- Magento
- Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
- PHP
- PHP 8.1 PHP 8.2 PHP 8.3
- Hyvä
- Compatible
- Package
-
wimakeit/module-checkout-hyva
Compatibility checker
Pick your stack to see if this module fits.
Changelog
Categories: Security, Feature, Fix, Perf, Admin, Deps.
[1.2.5] - 2026-08-27
Fix
- Hyvä checkouts get the current stylesheet again. The served CSS had drifted months behind the source it is compiled from: input fields lost to the theme's own styles, the payment-methods loading indicator was missing, and the checkout page kept its header and footer. Both stylesheets are rebuilt from the base module's sources.
- The stylesheets are no longer downloaded when the Wimakeit checkout or success page is switched off.
[1.2.0] - 2026-01-01
Feature
- Recompiled
checkout.cssso the.wm-co-method-iconrule fromwimakeit/module-checkout1.7.0 is served on Hyvä — payment-method icons now render correctly on Hyvä-themed checkouts.
Deps
- Composer constraint bumped to
wimakeit/module-checkout^1.7 for the payment-icon and expanded redirect-map release.
[1.1.0] - 2026-01-01
Feature
- Self-contained compiled stylesheets: this module now ships its own
checkout.cssandsuccess.css(the base module no longer carries them — Hyvä is the only theme that needs them served directly). - npm build tooling (
npm run build:css) to recompile both stylesheets from the base module's LESS partials, via thin entry files that work both in local development and insidevendor/wimakeit/.
Admin
- Layout blocks now reference
Wimakeit_CheckoutHyva::css/checkout.css(self-contained) instead ofWimakeit_Checkout::css/checkout.css.
Deps
- Composer constraint bumped to
wimakeit/module-checkout^1.6 to match the base module's slim-down release.
[1.0.1] - 2026-01-01
Fix
- Resolved a layout XML validation error (
Element 'block': This element is not expectedin<head>). The stylesheet block is now mounted into theafter.body.startcontainer — browsers load external stylesheets regardless of DOM position, so the visual result is identical.
[1.0.0] - 2026-01-01
Feature
- Initial release. Hyvä compatibility layer for
wimakeit/module-checkout: emits a proper<link rel="stylesheet">on checkout and success pages (Hyvä's native<css src="…"/>renderer drops therelattribute) and registers both modules with the Hyvä Tailwind build via an observer onhyva_config_generate_before.
Found a bug? Tell us about it.
A short form opens in a new tab — the module name and your language are already filled in. Share what you tried, what went wrong, and we will get back to you within one business day.
Report a bug for Checkout HyvaNeed help?
Our team is available to assist with integration.