Does Hyvä work with Magento Open Source?

How Hyvä fits into Magento Open Source

Magento Open Source (Magento Community) and Adobe Commerce share the same Magento 2 core. Hyvä is a frontend theme that sits on top of that core and focuses heavily on performance and reduced complexity.

• Core idea: Hyvä throws away Luma’s Knockout, RequireJS, and heavy JavaScript, and rebuilds the frontend with TailwindCSS and Alpine.js for speed and maintainability.
• Magento Open Source focus: Hyvä Commerce and Hyvä Theme are explicitly positioned around “maximising the power and scalability of the Magento Open Source platform”.
• Feature coverage: all standard Magento Open Source storefront features (catalog, cart, checkout, CMS, search, layered navigation, multi-store) are supported because Hyvä uses the same backend services.

In other words, if your store runs Magento Open Source 2.4.x, Hyvä is not only compatible—it’s essentially built for it.

Supported Magento Open Source versions

Hyvä follows Magento’s modern 2.4.x line. At the time of writing, the official docs and repositories list the following as supported or tested versions for the default theme:

• Magento Open Source 2.4.4-p9 or higher
• Magento Open Source 2.4.5-p8 or higher
• Magento Open Source 2.4.6-p7 or higher
• Magento Open Source 2.4.7-p1 or higher
• GitHub repo notes compatibility with Magento 2.4.0 and higher, but you should aim for supported 2.4.4+ LTS releases.

Always cross-check the exact version table in the latest Hyvä documentation and Magento release notes before upgrading your store.

Steps to install Hyvä on Magento Open Source

Here’s a simplified, real-world flow for getting Hyvä running on a Magento Open Source 2.4.x store. Always do this on a staging environment first.

1. Check your Magento & PHP versions
   Confirm you’re running a supported Magento Open Source 2.4.x version and compatible PHP (7.4, 8.1, 8.2, 8.3, 8.4 per docs). Upgrade if needed before touching your theme.
2. Add Hyvä repositories or configure open-source access
   For licensed/enterprise setups, add the private Hyvä Composer repository. With Hyvä now open source, you can also pull the default theme from GitHub/Packagist, following Hyvä’s official installation guide.
3. Require the Hyvä default theme via Composer
   Use Composer from your Magento Open Source project root to require the Hyvä theme package.
4. Run Magento setup and deployment commands
   Execute setup:upgrade, DI compilation, and static-content deploy so that Hyvä’s templates and Tailwind CSS bundle are generated for your locales.
5. Switch the storefront theme to Hyvä
   In Content → Design → Configuration, set Hyvä as the default theme for the relevant websites/store views.
6. Smoke test key storefront flows
   Visit category, product, cart, checkout, and customer account pages on staging. Fix any third-party extension conflicts before deploying to production.

# From your Magento Open Source 2.4.x root

# 1) (If needed) add Hyvä Composer repository – placeholder URL
composer config repositories.hyva-theme composer "https://"

# 2) Require Hyvä default theme (package name may differ)
composer require hyva-themes/magento2-default-theme

# 3) Run Magento upgrade & deployment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f

# 4) Flush caches
bin/magento cache:flush

Important notes: licensing, features, and the Magento Open Source ecosystem

1. Hyvä is now open source and free (for the theme)

• In November 2025, Hyvä announced that the theme is now open source and free, licensed under OSL3 + AFL3—just like Magento Open Source.
• This removes the old ~€1,000 license cost barrier, making Hyvä much easier to adopt for Magento Open Source merchants.
• Commercial products such as Hyvä Checkout, Hyvä Enterprise, and Hyvä Commerce remain paid add-ons.

2. Magento Open Source features that “just work” on Hyvä

Because Hyvä is a Magento 2 storefront theme, it supports all core Magento Open Source features out of the box, including:

• Catalog & products: categories, PDPs, product types, reviews, upsells/cross-sells.
• Cart & checkout: mini-cart, coupons, guest/registered checkout (with default checkout).
• Customer account: registration, login, dashboard, addresses, orders, wishlist.
• CMS & content: CMS pages, static blocks, Magento Page Builder content.
• Search & layered navigation, promotions, multi-store, multiple currencies.

3. Hyvä Commerce and Magento Open Source

Hyvä Commerce is a broader product suite (Theme, UI, Checkout, CMS extras) that explicitly builds on Magento Open Source while also supporting Adobe Commerce.

• For many Magento Open Source stores, Hyvä Theme alone is enough to see big performance gains.
• Hyvä Commerce adds CMS enhancements, admin features, UI component libraries, and more, still riding on Magento Open Source.

4. Extensions and widgets on Magento Open Source + Hyvä

Third-party extensions that target the storefront (navigation, search, SEO, forms, etc.) may need Hyvä compatibility modules. Many vendors now ship Hyvä-ready versions that support both Magento Open Source and Adobe Commerce.

Backend-only or API-style extensions usually work out of the box, since Hyvä doesn’t modify Magento’s backend logic.

Verification checklist: is your Magento Open Source store truly “Hyvä-ready”?

After installing Hyvä on a Magento Open Source staging store, run through this checklist before going live:

• Theme: Hyvä is selected as the default theme for your target website/store views.
• Catalog: category pages, PDPs, filters, and search work on desktop and mobile.
• Cart & checkout: add-to-cart, mini-cart, coupons, shipping/tax estimates, and full checkout succeed.
• Customer area: registration, login, password reset, account dashboard, orders, and addresses function.
• CMS & Page Builder: key CMS pages and Page Builder content display correctly (no broken layouts).
• Multi-store: language and currency switchers behave correctly if you use multiple store views.
• Extensions: any storefront extensions you rely on either work as expected or have Hyvä compatibility modules installed.
• Performance: Lighthouse/PageSpeed scores (LCP, CLS, TBT) clearly improve over your previous theme
• Logs & console: no recurring PHP errors in logs and no critical JavaScript errors in the browser console.

FAQs: Hyvä and Magento Open Source