Layered Navigation Hyva
v1.2.6
Layered Navigation 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
The Hyvä-frontend companion of wimakeit/module-layered-navigation. On a Hyvä storefront, install this one too: it supplies the Tailwind styling and registers the navigation with Hyvä's own Tailwind compilation.
You install this module in addition to the main module — never instead of it. The main module owns the filters, the configuration and the templates; this one owns the Hyvä styling.
Nothing is duplicated between the two. The main module's templates are already theme-neutral — BEM class names and Alpine.js — which is why this package is a stylesheet and a registration rather than a second implementation.
Who it's for
- Stores running Hyvä Themes that need a full-featured layered navigation
- Multi-frontend setups where Luma or Breeze and Hyvä coexist across store views and must look consistent
- Hyvä projects that want the filters restyled from their own theme without touching the module
Key benefits
- Tailwind styling, not a second template set — the same markup the main module renders on Luma and Breeze, dressed with Tailwind utilities. One set of templates to maintain, three frontends.
- Registers itself with Hyvä — both this module and the main one are pushed into Hyvä's configuration on
hyva:config:generate, so the base module's templates end up in the generated Tailwind content globs and purging works without any@sourcedirective. - Restyle from your theme — the same
--wm-ln-*custom properties are exposed on Hyvä as on Luma and Breeze, so a store rethemes the block identically on all three. The accent defaults to your Hyvä theme's ownprimarycolour. - No flash before Alpine boots — a server-side marker keeps collapsed groups and options past the "Show more" limit hidden until Alpine takes ownership, so the filter panel never flickers open on load.
- Alpine comes from Hyvä — the main module skips its own Alpine loader by inspecting the theme rendering the page, so store views still on Luma or Breeze keep theirs.
Compatibility
- Magento 2.4.x / Mage-OS equivalent
- PHP 8.1, 8.2, 8.3, 8.4
- Requires
wimakeit/module-layered-navigation1.2.3 or later (this is a styling addon, not a standalone navigation) - Requires the official Hyvä Themes base module (
hyva-themes/magento2-theme-module1.3+) - A Hyvä-based storefront theme, with a Tailwind build step
Install this module via Composer. Make sure your auth.json is configured with your Wimakeit credentials.
$ composer require wimakeit/module-layered-navigation-hyva:^1.2.6
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile
Installation notes
The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.
Required Wimakeit dependency
This module is a styling addon for Hyvä. It cannot work on its own — install the main module alongside it:
| Package | Minimum | Role |
|---|---|---|
wimakeit/module-layered-navigation | 1.2.3 | owns the filters, the configuration and the templates |
wimakeit/module-layered-navigation-hyva | this module | Tailwind styling and Hyvä registration |
Required third-party dependency
| Package | Minimum |
|---|---|
hyva-themes/magento2-theme-module | 1.3 |
Your storefront must run on a Hyvä-based theme. If your store is on Luma or Breeze, install only the main module and skip this one.
Install sequence
A Tailwind rebuild is part of the installation — the styles will not appear without it.
composer require wimakeit/module-layered-navigation-hyva
bin/magento module:enable Wimakeit_LayeredNavigationHyva
bin/magento setup:upgrade
bin/magento hyva:config:generate
Then, in your Hyvä theme directory:
npm run build-prod
hyva:config:generate is what registers both this module and the main one as Hyvä extensions, which is what puts the base module's templates into the generated tailwind.config.js content globs. Skip it and Tailwind purges the classes the filters rely on.
Configuration
There is no admin configuration specific to this module. Every setting — filters, options display, swatches, price rendering, AJAX, mobile drawer — lives in the main module under Stores → Configuration → Wimakeit → Layered Navigation, plus the per-attribute and per-category overrides described in its own install notes.
Customisation
Restyle from your Hyvä theme by overriding the custom properties the module exposes:
:root {
--wm-ln-accent: theme('colors.primary.DEFAULT');
--wm-ln-accent-soft: theme('colors.primary.lighter');
--wm-ln-ink: #1f2937;
--wm-ln-muted: #6b7280;
--wm-ln-paper: #ffffff;
--wm-ln-rule: #e5e7eb;
--wm-ln-rule-major: #d1d5db;
--wm-ln-radius: 4px;
--wm-ln-zoom-size: 180px;
}
These are the same --wm-ln-* properties the Luma and Breeze stylesheets expose, so a store themes the block identically on all three frontends.
- Version
- v1.2.6
- Support
- 12 months
- Last updated
- Aug 25, 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-layered-navigation-hyva
Compatibility checker
Pick your stack to see if this module fits.
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 Layered Navigation HyvaNeed help?
Our team is available to assist with integration.