How to Download and Install HyvΓ€ Open Source?

The HyvΓ€ Theme, which was previously priced at €1000, is now officially available as an open-source solution.

Starting from November 10, 2025, developers can access the HyvΓ€ Theme for free via GitHub and install it using complimentary Packagist Composer keys provided directly by HyvΓ€.

In this guide, we’ll walk you through how to download and install the HyvΓ€ Open Source theme, allowing you to take advantage of its speed, lightweight architecture, and high-performance benefitsβ€”without any licensing cost.

Let’s get started.

Steps to Download and Install HyvΓ€ Open Source

Follow the steps below to successfully install the free HyvΓ€ Theme on your Magento store.

Step 1: Create a HyvΓ€ Account

Visit the official HyvΓ€ website and begin the account registration process. Once completed, you will be automatically redirected to the HyvΓ€ Portal.

After logging in to the HyvΓ€ Portal, you will receive a confirmation email containing your HyvΓ€ Theme access credentials along with detailed installation instructions.

hyva-dashboard

Step 2: Obtain the Free License Key

You can also generate the required access keys directly from the HyvΓ€ Portal by following the steps below.

  • Navigate to HyvΓ€ Licenses and click on β€œGet a Free HyvΓ€ Theme License Key”.
  • You will be prompted to enter your domain name.
  • After entering the domain, click on β€œGet HyvΓ€ Theme for Free”.
  • Once the process is complete, all the necessary keys required for installation will be generated and made available.
enter-hywa-domain

Step 3: Retrieve Composer Credentials

In the All Licenses section of the HyvΓ€ Portal, locate the license entry associated with your registered domain.

Click on β€œShow Composer Credentials” to display your unique access information.

This section provides your private Packagist authentication key along with the required Composer commands needed to configure your environment for the HyvΓ€ Open Source installation.

Command format will appear similar to the example below:

				
					composer config --auth http-basic.hyva-themes.repo.packagist.com token {{Your token}}
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/{{ your repo name here}}/
				
			

Step 4: Install the HyvΓ€ Default Theme

Once your Composer credentials have been configured successfully, you can proceed with installing the core HyvΓ€ Theme package.

Run the following Composer command to download and install the default HyvΓ€ Theme:

				
					composer require hyva-themes/magento2-default-theme
				
			

The HyvΓ€ Theme uses its own optimized front-end build pipeline for handling assets efficiently. For best performance and compatibility, it is strongly recommended to disable Magento’s default JavaScript and CSS minification and bundling features, as they can introduce unnecessary overhead or unexpected behavior when used with HyvΓ€.

Execute the following configuration commands:

				
					php bin/magento config:set customer/captcha/enable 0
php bin/magento config:set dev/template/minify_html 0
php bin/magento config:set dev/js/merge_files 0
php bin/magento config:set dev/js/enable_js_bundling 0
php bin/magento config:set dev/js/minify_files 0
php bin/magento config:set dev/js/move_script_to_bottom 0
php bin/magento config:set dev/css/merge_css_files 0
php bin/magento config:set dev/css/minify_files 0
				
			

Step 5: Install Essential HyvΓ€ Modules

To ensure full functionality of the HyvΓ€ Theme, you must install a set of essential modules. These modules provide critical features such as Luma-based checkout compatibility and the Tailwind CSS Just-In-Time (JIT) compiler required for HyvÀ’s front-end workflow.

Install the following required modules to complete the setup:

				
					composer require hyva-themes/magento2-luma-checkout
composer require hyva-themes/magento2-cms-tailwind-jit
				
			

Step 6: Run Final Magento Commands and Verify the Installation

After all required packages and modules have been installed successfully, run the standard Magento CLI commands to complete the setup and apply the changes.

Execute the following commands to finalize the installation and verify that everything is working as expected:

				
					php bin/magento se:up
php bin/magento s:s:d -f
php bin/magento s:d:c
php bin/magento c:c
php bin/magento c:f
				
			
When you have successfully followed the above steps, you will be able to see the HyvΓ€ theme folder structure within your Magento installation directory.
				
					hyva-themes/
β”œβ”€β”€ magento2-base-layout-reset/
β”œβ”€β”€ magento2-cms-tailwind-jit/
β”œβ”€β”€ magento2-compat-module-fallback/

magento2-default-theme/
β”œβ”€β”€ .gitlab/
β”œβ”€β”€ etc/
β”œβ”€β”€ Hyva_Theme/
β”œβ”€β”€ i18n/
β”œβ”€β”€ Magento_AdvancedSearch/
β”œβ”€β”€ Magento_Bundle/

				
			

This concludes our step-by-step guide on how to successfully download and install the HyvΓ€ Open Source theme.

If you’re unsure about handling these steps on your own, our experienced HyvΓ€ experts are here to assist you throughout the process.

Our experts can help you with:

  • Building a custom HyvΓ€ theme from scratch
  • Customizing the theme to match your design and business requirements
  • Creating a child theme for specific Magento 2 projects

Get in touch with us today and make the most of the powerful and high-performance HyvΓ€ theme for your Magento 2 store.