README

⚠️ BETA WARNING: The main branch contains the beta version of MagewirePHP v3. For stable v1 documentation and releases, please switch to the 1.x branch.

MagewirePHP brings the power of reactive, server-driven UI development to Magento 2—without writing JavaScript. Inspired by Laravel Livewire, MagewirePHP lets you build dynamic, interactive frontend components using only PHP, fully integrated with Magento’s architecture.

Whether you're creating real-time search, dynamic product forms, or interactive checkout steps, MagewirePHP enables a clean, component-based approach that stays true to Magento’s conventions while simplifying complex frontend behavior.

• ✅ Write less JavaScript
• ✅ Maintain component logic in PHP
• ✅ Ideal for dynamic UIs like filters, modals, and configurators

MagewirePHP helps you deliver modern UX experiences in Magento—faster, cleaner, and with less frontend overhead.

Documentation

• Gettings Started
• Essentials
• Features
• Directives
• Concepts
• Advanced

Installation

To install Magewire in your Magento 2 project, follow these steps:

1. Require Magewire via Composer:

   composer require magewirephp/magewire

2. Enable the module:

   bin/magento module:enable Magewirephp_Magewire

3. Enable the theme compatibility module (determined per theme, in this case Hyvä):

   bin/magento module:enable Magewirephp_MagewireCompatibilityWithHyva

4. Run the setup upgrade command:

   bin/magento setup:upgrade

5. Deploy static content (when in production mode):

   bin/magento setup:static-content:deploy

6. Flush the cache:

   bin/magento cache:flush

Styles

To run styles, follow these steps:

1. Install packages:

npm ci

1. Run styles:

npx @tailwindcss/cli -i ./styles/magewire.css -o ./src/view/base/web/css/magewire.css --optimize

Use the --watch flag to re-compile on template changes.

Sponsors

Click here to start sponsoring.

Contributing

Thank you for considering contributing to Magewire! Please read the contribution guide to know how to behave, install and use Magewire for contributors.

Code of Conduct

In order to ensure that the Magewire is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Magewire, please create a merge request or an discussion. All security vulnerabilities will be promptly addressed.

License

Copyright © Willem Poortman

Magewire is open-sourced software licensed under the MIT license.

It's important to emphasize that this package is completely independent of any business entities. There is absolutely no involvement or interference from other companies expressing their preferences. This package is created by the community, for the community, ensuring its integrity and unbiased nature.