README

Real-time customer support chat module for Magento 2, powered by Symfony Mercure SSE messaging. Built for Hyva Themes with Alpine.js and Tailwind CSS.

MaxStan_LiveChat adds a full-featured live chat widget to the Magento storefront and a conversation management interface to the admin panel. Customers can open conversations, send messages, and receive real-time replies from store administrators — all without page reloads, using server-sent events via Mercure.

Warning

This package is currently in alpha (0.1.0-alpha1). The API is unstable and may introduce breaking changes between releases. Do not use in production.

⭐ Features

• Real-time messaging between customers and admins via Mercure SSE
• Storefront chat widget with Alpine.js (Hyva-compatible)
• Admin conversation view with chat widget
• Per-conversation Mercure topic authorization (private channels)
• Conversation limit enforcement (max 10 per customer)
• Paginated message history (50 messages per page)
• Integration test suite with fixtures, mocks, and spies

🛠️ Installation

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

# Set minimum stability to allow alpha version
composer config minimum-stability "alpha"
# Standard module installation
composer require max-stan/magento2-live-chat
bin/magento module:enable MaxStan_LiveChat
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Configure Mercure Hub according as described in the Magento 2 Mercure installation section

🚀 Contributing

Contributions are welcome! If you find a bug or have a feature request, feel free to open an issue or submit a pull request.