Does Hyvä work with Adobe Commerce (Magento Commerce)?

How does Hyvä work with Adobe Commerce?

Adobe Commerce (formerly Magento Commerce) and Magento Open Source share the same Magento 2 core codebase. Hyvä is simply a modern frontend theme on top of that core, so it can power both Magento Open Source and Adobe Commerce stores, including Adobe Commerce Cloud deployments.

• Hyvä Theme / Hyvä Commerce replaces the Luma frontend with a TailwindCSS + Alpine.js stack, but leaves Adobe Commerce backend features untouched.
• Adobe Commerce and Adobe Commerce Cloud are supported; Hyvä even documents Cloud-specific deployment requirements, such as handling the hyva-themes.json config file.
• Hyvä Commerce suite (Theme, UI, Checkout, extras) is explicitly positioned as a solution for both Magento Open Source and Adobe Commerce.

In practice, “Does Hyvä work with Adobe Commerce?” is almost always “yes”—the main nuance is which Adobe Commerce-only features you need on the storefront and whether Hyvä Enterprise is installed to support them.

When do you need Hyvä Enterprise on Adobe Commerce?

Hyvä Theme alone can power a lot of Adobe Commerce stores, especially those using mainly “Open Source-like” catalog and checkout flows. Hyvä Enterprise is the additional layer that provides compatibility for key Adobe Commerce-only features.

Features that typically need Hyvä Enterprise

• Adobe Commerce B2B Suite (company accounts, shared catalogs, quotes, requisition lists, etc.).
• Gift Cards (virtual/physical, code redemption UIs on the storefront).
• Rewards & Loyalty Points storefront components.
• Adobe Commerce Sensei-powered product recommendations and search widgets exposed in the frontend.

Hyvä Enterprise ships compatibility modules and UI components that plug these Commerce storefront features into the Hyvä stack while preserving performance benefits. Without Enterprise, the backend features still exist, but some storefront UIs may not render correctly.

Steps to run Hyvä on Adobe Commerce or Adobe Commerce Cloud

Here’s a pragmatic process to get Hyvä running on Adobe Commerce. This assumes Magento 2.4.x and SSH access to your environment (on-prem or Cloud).

1. Confirm your Adobe Commerce tech stack
   Verify you’re on a supported Magento 2.4.x version and note if you are using Adobe Commerce Cloud (PaaS) or an on-premise deployment. Adobe Commerce Cloud adds a few deployment constraints.
2. Install Hyvä Theme / Hyvä Commerce via Composer
   Add the Hyvä repositories and require the theme packages. If you plan to use Commerce-specific features, also plan for Hyvä Enterprise during this phase.
3. Generate and commit hyva-themes.json (Cloud only)
   On Adobe Commerce Cloud, generate the app/etc/hyva-themes.json after Magento is installed, then commit it. Without this file present during the build, Hyvä styles will not compile correctly.
4. Enable Hyvä as your storefront theme
   From the admin, switch the default theme to Hyvä. Then deploy static content and clear caches so storefront templates and assets are rebuilt.
5. Add Hyvä Enterprise if you use B2B or Commerce features
   For stores using B2B Suite, Gift Cards, Rewards, or Sensei, install Hyvä Enterprise and configure its compatibility modules to cover the relevant features.
6. Test key storefront and B2B flows
   Validate category, product, cart, checkout, login, account area, and all B2B journeys (quotes, company accounts, etc.) on staging before promoting to production.

# From your Adobe Commerce project root

# 1) Add Hyvä repositories (example placeholder)
composer config repositories.hyva-theme composer "https://repo.hyva.io/"

# 2) Require Hyvä Theme or Hyvä Commerce
composer require hyva-themes/magento2-theme

# 3) (Optional) Require Hyvä Enterprise for B2B / Commerce features
composer require hyva-themes/magento2-hyva-enterprise

# 4) Magento upgrade, DI compile and deploy static content
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f

# 5) Flush caches
bin/magento cache:flush

Notes: versions, licensing, and B2B behavior

1. Magento versions and compatibility

• Hyvä targets modern Magento 2.4.x releases, which are used by both Magento Open Source and Adobe Commerce. Always confirm version support in Hyvä’s docs before upgrading.
• Some third-party Commerce extensions will also need Hyvä compatibility modules, just as on Open Source builds.

2. Licensing and “Hyvä is now open source”

• As of November 2025, Hyvä Theme itself is open source and free, usable on Magento Open Source and Adobe Commerce.
• Commercial offerings like Hyvä Commerce, Hyvä Checkout, and Hyvä Enterprise are still licensed products with their own terms.
• Adobe Commerce itself remains a separately licensed platform; Hyvä does not change your Adobe licensing model.

3. B2B, Page Builder, and Sensei specifics

• Hyvä supports Magento Page Builder; on Adobe Commerce you can still create rich content. Some blocks may need Tailwind adjustment or Hyvä UI components for pixel-perfect layouts.
• B2B storefront UIs (quotes, negotiated pricing, requisition lists) are usually implemented via Hyvä Enterprise components. Without them, backend B2B logic exists but the storefront UX may not be wired into Hyvä correctly.
• Adobe Sensei recommendations and search widgets can be integrated into Hyvä’s frontend, but may require Enterprise and/or custom compatibility work depending on your setup.

Verification checklist: is your Adobe Commerce store really “Hyvä-ready”?

Use this checklist after you’ve installed Hyvä on Adobe Commerce (and optionally Hyvä Enterprise):

• Theme active: Hyvä is the selected storefront theme; Luma is disabled or unused.
• Cloud builds clean: On Adobe Commerce Cloud, build logs show successful Hyvä stylesheet compilation and no missing hyva-themes.json warnings.
• Core storefront flows OK: category, product, cart, checkout, search, and account pages all load without errors.
• Commerce/B2B features visible: if you use B2B Suite, Gift Cards, Rewards, or Sensei, the related storefront widgets and actions work correctly with Hyvä Enterprise enabled.
• Performance gains: Lighthouse/PageSpeed scores (especially LCP and TBT) are significantly improved versus Luma.
• No layout or JS conflicts: third-party extensions integrated into Adobe Commerce do not break Hyvä’s layout or cause console errors.

FAQs: Hyvä and Adobe Commerce