Getting Started With Hyvä Open Source — Installation & Setup Guide

Now that Hyvä Theme is Open Source, developers finally have access to a modern Magento frontend framework with unmatched performance.
This first article in the series walks you through:

• System requirements
• Installation steps
• Enabling the Hyvä theme
• Running setup commands
• Basic configuration

1. Requirements

Before installing Hyvä, make sure your server meets these versions:

Magento 2.4.4+
PHP 8.1+
Composer 2+
Node.js 16+/18+
Access to SSH

2. Download Hyvä Theme

Navigate to your Magento root directory:

cd /var/www/html/magento

Clone the free Hyvä Open Source repo:

git clone https://github.com/hyva-themes/magento2-frontend-theme-hyva.git app/design/frontend/Hyva/default

3. Register the Theme in Magento

Run Magento upgrade commands:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

Clear cache:

php bin/magento cache:flush

4. Activate Hyvä Theme in Admin

Go to:
Admin → Content → Design → Configuration → Your Store View

Select theme:
➡ Hyva/default

Save & refresh frontend.

Your Magento store is now running on Hyvä!