PHPackages                             blackbird/module-hyva-algolia-search - 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. [Search &amp; Filtering](/categories/search)
4. /
5. blackbird/module-hyva-algolia-search

ActiveMagento2-module[Search &amp; Filtering](/categories/search)

blackbird/module-hyva-algolia-search
====================================

Blackbird\_HyvaAlgoliaSearch makes Algolia\_AlgoliaSearch compatible with Hyvä Themes

102.0.0(3mo ago)1414.9k—3.8%8[1 issues](https://github.com/blackbird-agency/hyva-algolia-search/issues)MITJavaScriptPHP ~8.2|~8.3|~8.4

Since Aug 13Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/blackbird-agency/hyva-algolia-search)[ Packagist](https://packagist.org/packages/blackbird/module-hyva-algolia-search)[ RSS](/packages/blackbird-module-hyva-algolia-search/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (5)Versions (15)Used By (0)

hyva-algolia-search
===================

[](#hyva-algolia-search)

[![Latest Stable Version](https://camo.githubusercontent.com/12670c4c39d8174724b9ea99ad53a8bea7698cba7e21ccfdc1fb9db26a8c9507/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c61636b626972642f6d6f64756c652d687976612d616c676f6c69612d7365617263682e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/blackbird/module-hyva-algolia-search)[![License: MIT](https://camo.githubusercontent.com/b19e8dfa721871665985e19e67b3f129ae4e103c7cb72fb91e9cb43e78290ddd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f626c61636b626972642d6167656e63792f687976612d616c676f6c69612d7365617263682e7376673f7374796c653d666c61742d737175617265)](./LICENSE)

Compat module for Algolia Search on Magento 2 using Hyvä Themes. This requires:

- A [Hyvä Themes](https://www.hyva.io/) key
- Access to Algolia
- [blackbird/external-ressource-loader](https://github.com/blackbird-agency/external-resources-loader) to dynamically load all the Algolia ressources.

Compatibility
-------------

[](#compatibility)

This module is only compatible with algoliasearch from version 3.17 onwards.

Setup
-----

[](#setup)

Get the package

Composer Package: `composer require blackbird/module-hyva-algolia-search`

Zip Package: Unzip the package in app/code/Blackbird/HyvaAlgoliaSearch, from the root of your Magento instance.

Install the module
------------------

[](#install-the-module)

Go to your Magento root directory and run the following magento command:

```
php bin/magento setup:upgrade

```

**If you are in production mode, do not forget to recompile and redeploy the static resources, or use the `--keep-generated` option.**

Once the module is installed, please check the `app/etc/hyva-themes.json` file.
Depending on how the module has been installed, the following line must be now present in the `app/etc/hyva-themes.json` file.

### Installed using composer

[](#installed-using-composer)

```
{
  "extensions": [
    ...
    {
      "src": "vendor\/blackbird\/module-hyva-algolia-search\/src"
    },
    ...
  ]
}

```

### Installed using a Zip package

[](#installed-using-a-zip-package)

```
{
  "extensions": [
    ...
    {
      "src": "app\/code\/Blackbird\/HyvaAlgoliaSearch\/src"
    },
    ...
  ]
}

```

If the line is missing (notably for Magento 2.4.7 and late patches of Magento 2.4.6), please run the following command as per [official documentation](https://docs.hyva.io/hyva-themes/compatibility-modules/tailwind-source-css-merging.html#1-create-the-tailwind-sourcecss-file) and check that the new line appears:

```
bin/magento hyva:config:generate

```

What's included
---------------

[](#whats-included)

This compat modules offers full Hyvä-compatibility for the following Algolia services:

- Algolia Search
- Algolia InstantSearch
- Algolia Recommend
- Algolia Autocomplete
- Algolia Insights

Default styling is heavily inspired by the native theme of Hyvä Themes. Most style classes are used directly in the relevent templates or in the overridable `tailwind-source.css` file located in the `view/frontend/tailwind/` directory. Compare and wishlist feature has been reported.

Known issues, limitations
-------------------------

[](#known-issues-limitations)

- As of now, the Ajax add to basket feature has been implemented within a limited scope. Simple products have the quick ATB option but configurable products are **forwarded to the product page**.
- The native Hyvä Themes implementation of the option selection on a product tile **has not** been integrated yet.
- Filters styling on a listing page are quite raw at the moment. This will be improved in the future

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance79

Regular maintenance activity

Popularity37

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~77 days

Recently: every ~56 days

Total

8

Last Release

104d ago

Major Versions

100.0.1 → 101.0.02025-06-17

101.0.4 → 102.0.02026-02-03

PHP version history (2 changes)100.0.0PHP ~8.0.0||~8.1.0||~8.2.0||~8.3.0

101.0.4PHP ~8.2|~8.3|~8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12445118?v=4)[anthony-blackbird](/maintainers/anthony-blackbird)[@anthony-blackbird](https://github.com/anthony-blackbird)

---

Top Contributors

[![emilie-blackbird](https://avatars.githubusercontent.com/u/44096169?v=4)](https://github.com/emilie-blackbird "emilie-blackbird (25 commits)")[![klauss-blackbird](https://avatars.githubusercontent.com/u/84027084?v=4)](https://github.com/klauss-blackbird "klauss-blackbird (17 commits)")[![luderic-blackbird](https://avatars.githubusercontent.com/u/144663333?v=4)](https://github.com/luderic-blackbird "luderic-blackbird (7 commits)")[![mitchelvk](https://avatars.githubusercontent.com/u/12815485?v=4)](https://github.com/mitchelvk "mitchelvk (3 commits)")[![JDavidVR](https://avatars.githubusercontent.com/u/4760084?v=4)](https://github.com/JDavidVR "JDavidVR (3 commits)")[![PhilipRowe](https://avatars.githubusercontent.com/u/2877463?v=4)](https://github.com/PhilipRowe "PhilipRowe (1 commits)")[![mokadev](https://avatars.githubusercontent.com/u/876905?v=4)](https://github.com/mokadev "mokadev (1 commits)")[![CanvasCompanyHylke](https://avatars.githubusercontent.com/u/173889164?v=4)](https://github.com/CanvasCompanyHylke "CanvasCompanyHylke (1 commits)")

### Embed Badge

![Health badge](/badges/blackbird-module-hyva-algolia-search/health.svg)

```
[![Health](https://phpackages.com/badges/blackbird-module-hyva-algolia-search/health.svg)](https://phpackages.com/packages/blackbird-module-hyva-algolia-search)
```

###  Alternatives

[algolia/algoliasearch-magento-2

Algolia Search &amp; Discovery extension for Magento 2

1881.8M16](/packages/algolia-algoliasearch-magento-2)[smile/module-elasticsuite-cms-search

Smile Elasticsuite - Cms Pages Search Module for Smile Elasticsuite.

25916.7k1](/packages/smile-module-elasticsuite-cms-search)[mageworx/module-searchsuiteautocomplete

Search Suite Autocomplete extension by MageWorx for Magento 2

34293.0k1](/packages/mageworx-module-searchsuiteautocomplete)[smile/elasticsuite-for-retailer

Smile ElasticSuite for Retailers - Magento2 toolkit for Retailers : Store Locator, Availability and Prices per store, etc...

18235.4k](/packages/smile-elasticsuite-for-retailer)[smile/module-elasticsuite-rating

Smile ElasticSuite - Rating search module.

1492.1k2](/packages/smile-module-elasticsuite-rating)

PHPackages © 2026

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