hyva-module-compatibility

Identify and fix Magento 2 module compatibility issues with Hyvä Themes.

15|1|Updated Oct 24, 2025
One-click install
npx skills add https://github.com/ProxiBlue/claude-skills --skill hyva-module-compatibility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyva-module-compatibility
Source: https://github.com/ProxiBlue/claude-skills/tree/main/hyva-module-compatibility
Command: npx skills add https://github.com/ProxiBlue/claude-skills --skill hyva-module-compatibility

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps Magento developers ensure that modules behave correctly when running under Hyvä Themes, where Alpine.js and Tailwind replace traditional Knockout.js and RequireJS. It addresses common frontend compatibility issues that occur when admin-oriented modules render differently or fail to load on Hyvä-enabled storefronts.

Core Features & Use Cases

  • Hyvä-aware migration guidance for Magento 2 modules previously designed for default Luma templates.
  • Techniques for replacing block plugin dependencies with Hyvä-compatible templates, ViewModels, and Alpine.js.
  • Practical workflows for diagnosing frontend discrepancies (JS loading, layout blocks, and data rendering) and delivering robust front-end behavior.

Quick Start

Review the module to identify incompatibilities with Hyvä frontend patterns, then implement a Hyvä-compatible template override and a ViewModel-based data preparation approach, followed by Alpine.js integration to render interactive UI.

Frequently Asked Questions about hyva-module-compatibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Magento 2 module compatibility issues with Hyvä Themes?

To fix Magento 2 module compatibility issues with Hyvä Themes, you replace traditional Knockout.js and RequireJS dependencies with Hyvä-compatible templates, ViewModels, and Alpine.js. This addresses frontend discrepancies where admin-oriented modules fail to load or render incorrectly on the storefront.

Why does my Magento module render differently on a Hyvä frontend?

Your Magento module renders differently on a Hyvä frontend because Hyvä replaces default Luma templates, Knockout.js, and RequireJS with Tailwind and Alpine.js. Admin-oriented modules relying on traditional frontend layouts will fail to load or display correctly without compatible template overrides.

How do I migrate Magento Luma templates to Hyvä compatible frontends?

To migrate Magento Luma templates to Hyvä compatible frontends, implement a Hyvä-compatible template override and a ViewModel-based data preparation approach. This is followed by integrating Alpine.js to render interactive UI elements and replace outdated block plugin dependencies.

Does my Magento module need a ViewModel for Hyvä Theme compatibility?

Yes, implementing a ViewModel-based data preparation approach is essential for Hyvä Theme compatibility. It replaces traditional block plugin dependencies, ensuring your Magento module delivers robust frontend behavior and correctly passes data to Alpine.js components.

How do I diagnose JavaScript loading failures in Magento Hyvä modules?

To diagnose JavaScript loading failures in Magento Hyvä modules, review the module to identify incompatibilities with Hyvä frontend patterns. Check for lingering RequireJS dependencies and ensure data rendering relies on Alpine.js and ViewModel integration instead of Knockout.js.