Hyvä Compatibility

Install the Staff Hyvä package when the active storefront theme is based on Hyvä. It replaces the Luma-oriented Staff presentation for the login and password flows, Staff dashboard and navigation, customer list, customer creation, order list and view, reports, customer-facing representative block and supported cart interactions.

Compatibility reviewed

The mageb2b/staff-hyva package requires:

• the Staff base extension (mageb2b/staff)
• the Hyvä default theme (hyva-themes/magento2-default-theme)

Check the exact versions selected by Composer before deployment rather than assuming every future combination is interchangeable.

Install

composer require mageb2b/staff-hyva:*
php bin/magento module:enable MageB2B_StaffHyva
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Deploy the locales and theme scopes used by the store. If your project compiles Hyvä Tailwind CSS separately, include the Staff templates in the normal theme build and rebuild the CSS after installation.

What to verify

Use an ordinary Staff account in staging and check:

1. sign-in, forgotten password and password creation
2. Staff dashboard and account navigation
3. assigned-customer search and pagination
4. customer creation with the fields enabled in configuration
5. login as an assigned customer and clean return to Staff context
6. Staff order list, order view and any enabled order-edit path
7. order and product reports, including CSV export
8. cart price editing when the representative has permission
9. mobile navigation, forms, validation and focus states

The compatibility package covers the base Staff feature set. Separate Staff add-ons may require their own Hyvä bridge or version-specific support; do not assume this package restyles every optional module.

Troubleshooting

• If a page falls back to Luma markup, confirm the active theme inherits from Hyvä and the matching hyva_* layout handle is applied.
• If styling is missing, rebuild the theme CSS and redeploy static content for the correct store and locale.
• If a button renders but does nothing, inspect the browser console and verify the Hyvä-compatible template is active rather than a customization copied from Luma.
• Re-test project theme overrides after every Staff or Hyvä update.

No separate Hyvä screenshots are maintained in this KB yet; the functional checklist above is the release criterion.