PHPackages                             berrypath/magento2-berrypath-flow-hyva-compat - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. berrypath/magento2-berrypath-flow-hyva-compat

ActiveMagento2-module[Utility & Helpers](/categories/utility)

berrypath/magento2-berrypath-flow-hyva-compat
=============================================

Hyva compatibility module for BerryPath Flow.

1.0.1(1mo ago)2201MITHTMLPHP >=8.1

Since Jun 13Pushed 1w agoCompare

[ Source](https://github.com/BerryPath/magento2-berrypath-flow-hyva-compat)[ Packagist](https://packagist.org/packages/berrypath/magento2-berrypath-flow-hyva-compat)[ RSS](/packages/berrypath-magento2-berrypath-flow-hyva-compat/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)Dependencies (2)Versions (3)Used By (0)

BerryPath Guided Selling Flows for Magento 2 Hyvä
=================================================

[](#berrypath-guided-selling-flows-for-magento-2-hyvä)

[![BerryPath Guided Selling Flows for Magento 2 Hyvä](docs/banner-1544x500.png)](docs/banner-1544x500.png)

Bring BerryPath guided selling flows to Magento 2 Hyvä category pages, product pages, and CMS content with responsive, Tailwind-based storefront templates.

This companion package works with [`berrypath/magento2-berrypath-flow`](https://github.com/BerryPath/magento2-berrypath-flow). It uses the same Magento configuration and BerryPath Flow UUIDs; no second integration setup is required.

New to BerryPath? A free plan is available with **1 guided selling flow and up to 2,500 products**. Existing customers keep using their current plan.

- [Start for free](https://app.berrypath.eu/register)
- [Magento setup guide](https://www.berrypath.eu/docs/magento-module)
- [Main Magento module](https://github.com/BerryPath/magento2-berrypath-flow)
- [Live demo](https://www.berrypath.eu/demo/category)

Built for Magento 2 Hyvä storefronts
------------------------------------

[](#built-for-magento-2-hyvä-storefronts)

- Replaces the standard BerryPath frontend templates through Hyvä's compatibility fallback.
- Supports category, product, and CMS widget placements.
- Supports popup, sidebar, and inline guided selling flows.
- Preserves market, locale, product identifier, and assisted conversion behavior from the main module.
- Uses responsive Tailwind utility classes for banners, buttons, and inline flow containers.
- Keeps the stable `berrypath-flow-widget` CSS classes for integrations and custom styling.

Requirements
------------

[](#requirements)

- PHP 8.1 or newer.
- `berrypath/magento2-berrypath-flow`.
- `hyva-themes/magento2-compat-module-fallback`.
- A Magento 2 Hyvä storefront.

Composer installs the main BerryPath module and Hyvä compatibility fallback as package dependencies.

Installation
------------

[](#installation)

```
composer require berrypath/magento2-berrypath-flow-hyva-compat
bin/magento module:enable BerryPath_Flow BerryPath_FlowHyvaCompat
bin/magento setup:upgrade
bin/magento cache:flush
```

For local `app/code` development, place the module at:

```
app/code/BerryPath/FlowHyvaCompat

```

Rebuild the Hyvä theme CSS after installation when the storefront uses a production Tailwind build.

Configuration
-------------

[](#configuration)

This compatibility package adds no separate admin settings. Configure guided selling flows through the main Magento module:

```
Store defaults: Stores > Configuration > BerryPath > Flow
Category:       Catalog > Categories > BerryPath Flow
Product:        Catalog > Products > BerryPath Flow
CMS:            Content > Widgets > Add Widget > BerryPath Flow

```

Add the BerryPath Flow UUID or published widget URL to the desired placement. The Hyvä templates automatically use the configured display type, content, locale, market, and product identifier.

Template compatibility
----------------------

[](#template-compatibility)

The module registers this mapping with `Hyva\CompatModuleFallback\Model\CompatModuleRegistry`:

```
BerryPath_Flow → BerryPath_FlowHyvaCompat

```

Compatible templates are included for:

- `category.phtml`
- `product.phtml`
- `widget.phtml`

Tailwind content sources are declared under `view/frontend/tailwind/` so the module's template classes can be included in a Hyvä CSS build.

Screenshots
-----------

[](#screenshots)

Ask relevant, easy-to-answer questions:

[![Guided selling question](docs/screenshots/guided-question.png)](docs/screenshots/guided-question.png)

Turn shopper answers into focused product recommendations:

[![Guided selling recommendations](docs/screenshots/recommendation-results.png)](docs/screenshots/recommendation-results.png)

Use the same guided selling placements across Magento 2 Hyvä content, category, and product pages:

[![Homepage CMS widget](docs/screenshots/homepage-widget.png)](docs/screenshots/homepage-widget.png)

[![Category page widget](docs/screenshots/category-widget.png)](docs/screenshots/category-widget.png)

[![Product page widget](docs/screenshots/product-widget.png)](docs/screenshots/product-widget.png)

License
-------

[](#license)

MIT. See [LICENSE](LICENSE).

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance96

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

2

Last Release

39d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2ee4de80f0235969a01da2eb7c088d6cf002d75a666728c6be5d81fc7ab186ed?d=identicon)[sidworks](/maintainers/sidworks)

---

Top Contributors

[![jellesiderius](https://avatars.githubusercontent.com/u/8039493?v=4)](https://github.com/jellesiderius "jellesiderius (8 commits)")[![GrimLink](https://avatars.githubusercontent.com/u/4387541?v=4)](https://github.com/GrimLink "GrimLink (1 commits)")

---

Tags

berrypathe-commercemagentomagento2magento2-extensionmagento2-module

### Embed Badge

![Health badge](/badges/berrypath-magento2-berrypath-flow-hyva-compat/health.svg)

```
[![Health](https://phpackages.com/badges/berrypath-magento2-berrypath-flow-hyva-compat/health.svg)](https://phpackages.com/packages/berrypath-magento2-berrypath-flow-hyva-compat)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)