Purchase Hyvä Theme from hyva.io. After purchase, log into your Hyvä account and navigate to your licences. You’ll find a Composer authentication token — this is what allows Composer to download the package.

Add this token to your Magento root auth.json file:

{
  "http-basic": {
    "gitlab.hyva.io": {
      "username": "your-token-username",
      "password": "your-token-password"
    }
  }
}

If auth.json doesn’t exist in your Magento root, create it. Never commit this file to version control — add it to .gitignore.

Run the following command from your Magento root directory:

composer require hyva-themes/magento2-theme-module

This installs the core Hyvä module and all its dependencies. Depending on your server speed and the number of dependencies, this takes 5–15 minutes. You should see Composer resolving dependencies and installing packages.

If you’re also installing the Hyvä compatibility modules for specific extensions (recommended), install those at the same time:

# Example: Hyvä compat for a common extension
composer require hyva-themes/magento2-YOUR-extension-compat

The third step to install Hyvä Theme on Magento 2 is running the standard Magento upgrade and compile sequence:

# Register new modules
bin/magento setup:upgrade

# Compile dependency injection
bin/magento setup:di:compile

# Deploy static content (use -f to force, add locales as needed)
bin/magento setup:static-content:deploy -f en_GB en_US

# Flush cache
bin/magento cache:flush

setup:upgrade registers the Hyvä modules and creates any necessary database tables. setup:di:compile generates the compiled dependency injection configuration — on large stores this can take 10–20 minutes. setup:static-content:deploy deploys the CSS and JS assets.

With the module installed, activate and install Hyvä Theme through the Magento admin panel:

• Go to Content → Design → Configuration
• Select your store view and click Edit
• Under Default Theme, select Hyvä from the dropdown
• Click Save Configuration
• Flush the full page cache: bin/magento cache:flush full_page

Visit your storefront. A successful install Hyvä Theme shows the default Hyvä design — clean, minimal, and significantly faster than Luma. At this point the store is functional but unstyled to your brand. That’s expected — customisation comes next.

The final step to fully install Hyvä Theme on Magento 2 is creating a child theme. Never modify the base theme files directly — always create a child theme that inherits from Hyvä:

# Create your theme directory structure
mkdir -p app/design/frontend/YourVendor/YourTheme

# Create registration.php
cat > app/design/frontend/YourVendor/YourTheme/registration.php << 'EOF'
<?php
use Magento\Framework\Component\ComponentRegistrar;
ComponentRegistrar::register(
    ComponentRegistrar::THEME,
    'frontend/YourVendor/YourTheme',
    __DIR__
);
EOF

# Create theme.xml
cat > app/design/frontend/YourVendor/YourTheme/theme.xml << 'EOF'
<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">
    <title>Your Theme</title>
    <parent>Hyva/default</parent>
</theme>
EOF

Now set up Tailwind CSS for your child theme:

# Copy the Tailwind config and package.json from Hyvä base
cp vendor/hyva-themes/magento2-theme-module/web/tailwind/tailwind.config.js \
   app/design/frontend/YourVendor/YourTheme/web/tailwind/

cp vendor/hyva-themes/magento2-theme-module/web/tailwind/package.json \
   app/design/frontend/YourVendor/YourTheme/web/tailwind/

# Install Node dependencies
cd app/design/frontend/YourVendor/YourTheme/web/tailwind
npm install

# Build for development (with watch)
npm run watch

# Build for production
npm run build-prod