Hyvä Theme Add-On

Install MageB2B_B2BQuoteHyva when the active storefront theme is based on Hyvä. It replaces the Luma-oriented quote presentation with Hyvä layouts, templates, view models, and frontend interactions while keeping the quote data and Magento Admin workflow in the base module.

Requirements

The compatibility package requires a compatible base B2B Quote installation, the supported Hyvä default theme, and an active Hyvä storefront on the store view being verified. Check the package dependency constraints during Composer resolution instead of copying package constraints into deployment notes.

Installing the compatibility package on a Luma store does not convert that store to Hyvä.

Install the package

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/b2b-quote-hyva:*

php bin/magento module:enable MageB2B_B2BQuoteHyva
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

See the installation guide for where to find the repository placeholders and access token (Account > Licenses).

Use the deployment commands appropriate for the current Magento mode and locale set. On a development environment, a full production-style compile and deployment may not be necessary.

Rebuild the Hyvä CSS

The package contains Tailwind source files and scans its own templates/**/*.phtml and layout/**/*.xml. Make sure the module is included by the Tailwind build used by the active child theme, then run that theme's normal Hyvä CSS build.

If the PHP templates render but controls look unstyled, do not stop at cache:flush: first confirm that the generated theme CSS contains the module's classes and that the rebuilt asset is the file delivered by the current store view.

Storefront areas covered

The compatibility module supplies Hyvä presentation for:

quote list, create, view, edit, history, compare, messages, and split pages
the mini quote drawer and quote header link
product-page, category-page, and cart add-to-quote actions
project and agreement pages
related customer-account and order views

The precise action available to a buyer still depends on the base B2B Quote configuration, customer group, ownership, and current workflow state.

Verify one complete workflow

Sign in as an allowed B2B customer on the Hyvä store view.
Add a real catalog product to a quote from the product page.
Open the mini quote and confirm the item, quantity, and link to the quote editor.
Save and submit the quote.
Open the customer quote list and quote detail page.
Check a state-dependent action such as messaging, editing, accepting, or declining.
Repeat the product and quote pages at a mobile viewport.

Troubleshooting

Quote blocks are missing

Confirm that Hyva_Theme, Hyva_CompatModuleFallback, MageB2B_B2BQuote, and MageB2B_B2BQuoteHyva are enabled. Then inspect the layout handle of the affected page and make sure the compatibility layout is merged.

Two “Add to Quote” actions appear

The compatibility module disables the Luma catalog plugins that would otherwise duplicate the Hyvä action. A duplicate usually points to stale dependency-injection configuration or a third-party plugin that adds another button. Compile the merged DI configuration and identify both rendered blocks before hiding either one with CSS.

The page mixes Luma and Hyvä markup

Confirm the active theme for the affected store view, clear generated layout/cache state, and check whether another compatibility module overrides the same handle or template after B2B Quote.

Interactions do not respond

Check the browser console and network requests, verify that current static assets are deployed, and confirm that the quote action is permitted for the signed-in customer and current quote status.