MageOS Widgetkit Module for Magento

Kit of CMS Widgets compatible with Hyvä frontend theme.

Overview

The Widgetkit module defines a pre-built list of cms widgets with dedicated preview for Magento's pagebuilder.
As far as this module is full compatible with Hyvä, each preview generates Tailwind CSS style when component is loaded on pagebuilder stage, alpine JS bindings are resolved on previews too.

🚀 Features

1. Full support for Hyvä frontend: PageBuilder previews render each widget's real, already-compiled theme Tailwind CSS (no runtime CSS compilation) and initialize Alpine.js bindings on the cms_block/cms_page edit controllers. The preview theme is picked automatically per CMS page/block: it uses the Hyvä theme assigned to the entity's own store view when there is one, otherwise falls back to an admin-configurable default (Stores → Configuration → MageOS Widgetkit → PageBuilder Preview), whose theme list only ever offers Hyvä child themes.

2. Customizable slideshow widget

3. Customizable slider widget

4. Customizable product slider widget

5. Customizable grid widget

6. Customizable product grid widget

7. Customizable information grid widget – icon, title, description and a CTA button per item

8. Customizable accordion widget – collapsible content sections

9. Customizable marquee widget – infinitely scrolling strip of logos/content

10. Customizable tab widget – switchable content panels

11. Customizable stacked grid widget – full-width stacked rows, in 3 layout variants

12. Customizable countdown widget – counts down to a target date

13. Customizable banner widget – image + title/text/CTA, in 5 layout variants

🔧 Installation

1. Install it into your Mage-OS/Magento 2 project with composer:

   composer require mage-os/module-widgetkit
   

2. Enable module

   bin/magento module:enable MageOS_Widgetkit
   bin/magento setup:upgrade
   

🤝 Changelog

Please see CHANGELOG for more information on what has changed recently.

📄 License

The MIT License (MIT). Please see License File for more information.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog
and this project adheres to Semantic Versioning.

2.0.0

Change of main logic

• Changing the core logic: switching from Twind.js to compiling CSS previews using Sabberworm in PHP.
• Reducing the number of templates assigned to widgets: with Tailwind, it is better to avoid generating CSS classes via PHP and instead rely more heavily on PHTML markup.

1.4.8

Fixed

• A11y fix for slideshow and slider widgets snap-track

1.4.7

Updated

• Enhance widgets extensibility enabling every child template override through $block->setData() inside phtml

1.4.6 - 2026-04-21

Fixed

• PHP 8.4 and 8.5 compatibility: add missing parameter type in ProductWidget::loadProducts, add explicit void return type on Observer::execute, guard against null module path before substr(), add missing @throws PHPDoc on Adminhtml\Grid\Preview::renderMainTemplate

1.4.5

Fixed

• Fix null dereference on product loading in ProductWidget
• Remove invalid return statement from constructors in Slider/Preview and Slideshow/Preview
• Change readonly private to protected readonly in RegisterModuleForHyvaConfig

1.4.4

Updated

• Fix dotnav for slider/product-slider widgets on mobile

1.4.3

Updated

• Add anchor to slider item container if button content is not set

1.4.2

Fixed

• Fix slideshow min-height management

1.4.1

Updated

• Add missing frontend controls on widgets parameters

1.4.0

• Update composer JSON making the module installable for Magento Openso

1.3.2

Updated

• Add the right file type for Tailwind 4 compatibility

1.3.1

Updated

• Remove css functions from adminhtml/web/css css preview files due to incompatibility with nativa pagebuilder template sacing feature.

1.3.0

Added

• Grid and Product grid widgets are available!

1.2.0

Added

• product Slider widget is available!

1.1.3

Fixed

• Fix dotnav navigation click issue for slider widget

1.1.2

Fixed

• Fix tailwind compilation for widgetkit missing css tailwind classes

1.1.1

Updated

• Slider widget minor fixes made

1.1.0

Added

• Slider widget is available!

1.0.0

Added

• First Commit, slideshow widget is available!