← All User Guides

Luxor Theme for Hyvä Stores

Current version: 2.2.0

Overview

Luxor is a premium Hyvä child theme for Magento 2, designed for fashion brands, luxury labels, and high-end quality products. It delivers a modern black & white aesthetic, strong typography, and a distraction-free shopping experience, paired with Hyvä's frontend performance.

  • Minimalist black & white luxury design
  • Optimized for fashion, accessories, and premium products
  • Built on Hyvä + Tailwind CSS
  • Ultra-fast performance and clean HTML output
  • SEO-friendly structure
  • Fully update-safe child theme architecture

Free installation is included with your purchase — contact us (see Support below) if you'd like us to install it for you.

Requirements

  • Magento 2.4.7 or 2.4.8
  • Hyvä Theme, installed and activated
  • PHP 8.1 or newer
  • MySQL 8.0+
  • Node.js 18+ (frontend build tooling)
  • Composer 2.x

Heads up: on some hosts the default php and composer commands point to an older PHP version than the one Magento actually needs. If a command fails with a PHP version error, run php -v to see what's active, then call the specific binary instead — e.g. /usr/bin/php84 /usr/bin/composer require ....

First steps: installing Hyvä (free)

Hyvä is free but requires registration to access its private Composer repository.

1. Create your free Hyvä license

Register your store domain at hyva.io/licenses/manage/shops — you will receive a private Packagist repository URL and an access token.

2. Configure Composer for Hyvä Private Packagist

Replace <your-hyva-license-key> with your own Hyvä license key (from your Hyvä account, not from ShopWhizzy):

composer config --auth http-basic.hyva-themes.repo.packagist.com token <your-hyva-license-key>
composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/<your-hyva-license-key>/

3. Install the core Hyvä theme (minimal setup)

composer require hyva-themes/magento2-default-theme \
 hyva-themes/magento2-cms-tailwind-jit \
 hyva-themes/magento2-compat-module-fallback \
 hyva-themes/magento2-luma-checkout \
 hyva-themes/magento2-payment-icons

Installing the Luxor theme

Luxor is installed via Composer, from your own private ShopWhizzy repository. Find your repository URL and license code on My Modules in your account.

4. Get your ShopWhizzy Composer access

Copy the two commands under "Composer Install > 2. ShopWhizzy access" on your My Modules page and run them in your Magento project root:

composer config repositories.shopwhizzy composer https://shopwhizzy.com/composer/<your-license-token>/
composer require shopwhizzy/luxor-theme

Your Composer access follows your license, so it stops working automatically if the license lapses.

5. Run the Magento setup commands

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

Activating the theme

In the Magento Admin, go to Content > Design > Configuration and assign:

  • ShopWhizzy/child_luxor — the storefront theme
  • ShopWhizzy/child_checkout — under Stores > Configuration > Hyvä Theme > Hyvä Checkout

Recommended: for the best design results, pair Luxor with Amasty One Step Checkout, set to the modern layout with 2 fixed columns. Luxor's checkout styling is built with this combination in mind.

Configuration

Luxor adds its own admin section at Stores > Configuration > Luxor Theme, where every theme option lives — no code edits needed for day-to-day changes.

General
Enable the theme, home page layout, scroll-to-top button, license code.
Header
Header layout and desktop menu version, dark/light and sticky header, logos for dark and light header, top USPs bar.
Footer
Footer layout, logo, text and column content, social links, payment icons, newsletter block, disclaimer and copyright text.
Product Page
Product page version, product USPs, share buttons, product disclaimer text.
Category Page
Category page and product card versions, product image ratio, card gallery, quick view, brand attribute, subcategory layouts.
Contact Us
Google Maps embed code.
Blog
Table of contents toggle, trust block title and USPs (requires the Magefan Blog module).

Iconography

Luxor uses the HugeIcons Stroke Sharp set (weight 1). Only the icons the theme actually needs are bundled to keep the package small — if you need a specific icon added, contact us and we'll include it in an upcoming release.

Updating the theme

composer update shopwhizzy/luxor-theme

Then repeat the Magento setup commands step above. Luxor is a self-contained child theme, so updates don't overwrite your store's own customizations outside the theme's own files.

Support

Need a hand with installation or configuration? Reach out at info@shopwhizzy.com or through shopwhizzy.com.