Hyvä Compatibility Packages

Sublogin uses separate Hyvä bridge packages for the base storefront and four feature add-ons. Install one bridge for every Sublogin package whose storefront screens you use.

Package map

Storefront area	Hyvä package	Required Sublogin package
My Sublogins, create/edit, account navigation, reports and order labels	`mageb2b/sublogin-hyva`	`mageb2b/sublogin` 2.3.9 or newer
Roles, groups and permission-aware catalog/cart UI	`mageb2b/sublogin-role-hyva`	`mageb2b/sublogin-role` 2.2.6 or newer
Budget pages and summaries	`mageb2b/sublogin-budget-hyva`	`mageb2b/sublogin-budget` 2.1.14 or newer
Sublogin catalog pages	`mageb2b/sublogin-custom-catalog-hyva`	Sublogin 2.3.10, Custom Catalog add-on 1.0.3 and Sublogin Hyvä 2.0.4 or newer
Approval notices and order actions	`mageb2b/sublogin-orderapproval-hyva`	Order Approval 2.0.12 and Sublogin Hyvä 2.0.4 or newer

All five bridges require Hyvä Default Theme 1.1.18 or newer. Let Composer resolve the exact compatible versions.

Install the base bridge

composer require mageb2b/sublogin-hyva
php bin/magento module:enable MageB2B_SubloginHyva
php bin/magento setup:upgrade

Install feature bridges in the same way. For example, a store using Role and Order Approval needs both corresponding Hyvä packages in addition to the base bridge.

Verify the storefront

Test with the same buyer in Luma-compatible staging and Hyvä staging where possible:

open My Sublogins and create or edit a record;
test roles and groups if installed;
check budget summaries and checkout enforcement;
verify catalog product visibility and cart access;
place an order that requires approval, then approve, decline and edit it as permitted;
test mobile navigation and validation messages.

A successful setup:upgrade only proves the modules are registered. It does not prove that every customized Hyvä checkout or account template still exposes the required Sublogin data.

This KB pass intentionally uses no separate Hyvä screenshots. The package and workflow guidance remains source-backed.