Magento 2 ships with the Luma theme as its default starting point. Many merchants build their sites on Luma, and popular themes such as Pearl and Porto even extend it. While those themes give you a lot of design options, they also bring Luma’s heavy weight with them. Luma loads dozens of JavaScript libraries and several CSS files, which slows page rendering, hurts load times, and drags down Google PageSpeed Insights scores. For merchants, that slowdown translates into lower SEO rankings, a poorer user experience, and fewer conversions.
That’s exactly what the Hyvä theme is designed to fix. Instead of building on top of Luma, Hyvä starts from scratch with performance in mind. It’s built with Tailwind CSS and Alpine.js, relies mainly on vanilla JavaScript for interactivity, and bundles everything into a single, ultra‑lightweight CSS file. The result is faster page loads, higher Core Web Vitals scores, and a smoother, more efficient developer workflow.
Hyvä Theme Architecture Overview
Hyvä isn’t just a look‑and‑feel change, it completely changes how the Magento 2 frontend works.
Instead of using old libraries like RequireJS, Knockout.js, and jQuery, Hyvä cuts the stack down to only what’s needed and replaces them with:
- Vanilla JavaScript & Alpine.js – light, modern interactivity
- Tailwind CSS – a utility‑first framework that creates a small, optimized stylesheet
- Fewer Dependencies – no Knockout, no RequireJS, and no heavy third‑party JS
- GraphQL Support – smooth data fetching that works with Magento’s API features
- Simplified Development – clean code that speeds up building and customizing
How to Install Hyvä Theme in Magento 2?
Getting Hyvä set up is easy once you have a license. The steps below walk you through the whole process.
Hyvä License Cost
Hyvä is a paid Magento 2 theme. You pay a one‑time fee of €1,000 for each project or domain. What you get with that fee:
- Lifetime access to the Hyvä theme files
- Access to the Hyvä community Slack channel
- Full documentation and support
It’s a one time investment that adds real value by making your site faster, boosting SEO, and delivering long‑term return on investment.
Step-by-Step Hyvä Installation
Once you’ve purchased the Hyvä theme license, follow these steps to install Hyvä theme in your Magento 2 instance
- Ensure Required Magento GraphQL Modules Are Enabled. Hyvä relies on Magento GraphQL modules. If you have any GraphQL modules disabled in your existing project, enable them back.
- Add Your License Key to Composer, you can find your license key in your Hyvä theme purchase confirmation mail
composer config --auth http-basic.hyva-themes.repo.packagist.com token yourLicenseAuthentificationKey
- Then configure the private repository for your project. you can find this detail in your Hyvä theme purchase confirmation mail
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/yourProjectName/
- Install the Hyvä Theme Package
composer require hyva-themes/magento2-default-theme
- Run Setup Upgrade
bin/magento setup:upgrade
- Activate Hyvä Theme in Admin
Navigate to Content → Design → Configuration, Select the store view you want to edit, Apply the hyva/default theme - Deploy Static Content & Clear Cache
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
Go to frontend to see your new Hyvä powered site.
Hyvä Compatible Extensions
Because Hyvä uses a modern front‑end stack, not every Magento 2 extension will work out of the box. That’s why you need to pick extensions that are made for Hyvä.
At MageArmy, we offer a variety of Hyvä‑ready Magento 2 extensions. Here are our top three recommended modules:
- Magento 2 Free Shipping Bar
Show a progress bar that updates as customers add items to their cart. It nudges shoppers to reach the free‑shipping threshold and is built to load quickly with Hyvä. - Magento 2 International Telephone Input & Validation
Improve checkout UX by allowing customers to enter their phone number in the correct international format with real-time validation. Seamlessly integrates with Hyvä’s lightweight frontend. - Magento 2 Category Wise FAQ
Enhance user experience by displaying organized FAQs. Hyvä compatibility ensures FAQs load instantly without affecting site speed.