# siteation/magento2-hyva-icons-lucide

> Lucide icons for Hyva Themes

`composer require siteation/magento2-hyva-icons-lucide`

Canonical URL: https://packagento.com/siteation/magento2-hyva-icons-lucide

## At a glance

- **Vendor**: siteation (https://packagento.com/siteation.md)
- **Latest version**: 2.3.0 — released 2026-03-24
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/siteation/magento2-hyva-icons-lucide and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require siteation/magento2-hyva-icons-lucide:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Lucide icons for Hyva Themes

## README

[![Packagist Version](https://img.shields.io/packagist/v/siteation/magento2-hyva-icons-lucide?style=for-the-badge)](https://packagist.org/packages/siteation/magento2-hyva-icons-lucide)
![Supported Magento Versions](https://img.shields.io/badge/magento-%202.4-brightgreen.svg?logo=magento&longCache=true&style=for-the-badge)
[![Hyva Themes Module](https://img.shields.io/badge/Hyva_Themes-Module-3df0af.svg?longCache=true&style=for-the-badge)](https://hyva.io/)
![License](https://img.shields.io/github/license/siteation/magento2-hyva-icons-lucide?color=%23234&style=for-the-badge)

This Magento 2 module adds the option to use [Lucide Icons](https://lucide.dev/) in your Hyva frontend.

This requires that you have a working Hyva frontend,
this icon pack was made specifically for Hyva Themes and will not work out of the box with any other frontend.

### Installation

Install the package via;

```bash
composer require siteation/magento2-hyva-icons-lucide
bin/magento setup:upgrade
```

> **Warning** This Module requires Magento 2.4 or higher and requires Hyva!
> For more requirements see the `composer.json`.

### How to use

By default this module loads nothing.

To use this icon pack instead of the default Hyva icons, add the following to your phtml file;

```php
<?php
use Hyva\Theme\Model\ViewModelRegistry;
use Siteation\HyvaIconsLucide\ViewModel\LucideIcons;

/** @var ViewModelRegistry $viewModels */

/** @var LucideIcons $lucideIcons */
$lucideIcons = $viewModels->require(LucideIcons::class);
```

and use the LucideIcons just as the HeroIcons in Hyva;

```php
<?= $lucideIcons->menuHtml('p-1', 24, 24, ["aria-label" => "Open menu"]) ?>
```

#### Using SVG icons in CMS content

You can now also use the SVG icons in your CMS content.

Bringing svg icon support to you CMS pages, Blocks and Widgets.

```txt
{{icon "lucide/menu"}}
```

[For more information on how and what see the Hyva Docs](https://docs.hyva.io/hyva-themes/writing-code/working-with-view-models/svgicons.html#using-svg-icons-in-cms-content)

> This feature is supported since Hyva v1.1.12

### Other icon packs for Hyva

- For Icons packs see https://github.com/topics/hyva-icons

_If you are looking for a Luma based option [checkout this icon pack instead](https://github.com/GrimLink/magento2-icon-packs)._

> [!note]
> **Note:** Starting from Hyvä version 1.3.15, Hyvä includes its own Lucide Icons integration. This implementation differs slightly from the one provided by this module, but both can be used alongside each other without conflict.

### Icon License

[Lucide Icons](https://lucide.dev/) used in this module were created by [Lucide Contributors](https://github.com/lucide-icons) under a [ISC License, found here](https://github.com/lucide-icons/lucide/blob/main/LICENSE)

## Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

### Unreleased

### 2.3.0 - 2026-03-24

#### Changed
- Updated Lucide icons to v1.0.1.
  **Minor Breaking Change:** All branded icons have been removed.
  For branded icons, use [Simple Icons](https://simpleicons.org/) instead.

### 2.2.10 - 2026-01-18

#### Changed
- updated Lucide icons to v0.562.0

### 2.2.9 - 2025-11-07

#### Changed
- updated Lucide icons to v0.552.0

### 2.2.8 - 2025-08-02

#### Changed
- updated Lucide icons to v0.535.0

### 2.2.7 - 2025-07-04

#### Changed
- updated Lucide icons to v0.525.0

### 2.2.6 - 2025-06-02

#### Changed
- updated Lucide icons to v0.511.0

### 2.2.5 - 2025-05-01

#### Changed
- updated Lucide icons to v0.503.0

### 2.2.4 - 2025-04-07

#### Changed
- updated Lucide icons to v0.486.0

### 2.2.3 - 2025-02-06

#### Changed
- Update Lucide icons to v0.473

### 2.2.2 - 2025-01-10

#### Changed
- Update Lucide icons to v0.469

### 2.2.1 - 2024-12-02

#### Changed
- Update Lucide icons to v0.462

### [2.2.0] - 2024-11-12

[2.2.0]: https://github.com/Siteation/magento2-hyva-icons-lucide/compare/2.1.0...2.2.0

#### Changed
- Update Lucide icons to v0.454,
  **Minor Breaking Change** Includes icon name changes in https://github.com/lucide-icons/lucide/releases/tag/0.447.0

### 2.1.3 - 2024-10-11
#### Fixed
- Moved `SvgIcons` argument from global scope to frontend and adminthtml scope

### 2.1.2 - 2024-10-07
#### Changed
- Update Lucide icons to v0.446

### 2.1.1 - 2024-09-14
#### Fixed
- Missing viewbox with introduction of svgo

### [2.1.0] - 2024-09-04

[2.1.0]: https://github.com/Siteation/magento2-hyva-icons-lucide/compare/2.0.0...2.1.0

#### Added
- svgo to build actions, to improve svg size and remove the lucide css class from the svg

#### Changed
- Update Lucide icons to v0.438

#### Fixed
- Older icons not being removed

#### Removed
- Icons that are not part of the current Lucide icons version

### 2.0.6 - 2024-07-07

#### Changed
- Update Lucide icons to v0.399

### 2.0.5 - 2024-06-02

#### Changed
- Update Lucide icons to v0.381

### 2.0.4 - 2024-05-01

#### Changed
- Update Lucide icons to v0.376

### 2.0.3 - 2024-04-05

#### Changed
- Update Lucide icons to v0.364

### 2.0.2 - 2024-02-05

#### Changed
- Update Lucide icons to v0.320

### 2.0.1 - 2024-01-02

#### Changed
- Update Lucide icons to v0.303

### [2.0.0] - 2023-12-08

[2.0.0]: https://github.com/Siteation/magento2-hyva-icons-lucide/compare/1.0.0...2.0.0

#### Changed
- **Breaking Change** Update Lucide icons to v0.294,
  see release note: https://github.com/lucide-icons/lucide/releases/tag/0.293.0

### 1.0.11 - 2023-11-01

#### Changed
- Update Lucide icons to v0.291

### 1.0.10 - 2023-09-21

#### Changed
- Update Lucide icons to v0.274

### 1.0.9 - 2023-08-18

#### Changed
- Update Lucide icons to v0.268

#### Fixed
- Location for iconPathPrefix

### 1.0.8 - 2023-07-02

#### Changed
- Update Lucide icons to v0.257

### 1.0.7 - 2023-06-06

#### Changed
- Update Lucide icons to v0.236

### 1.0.6 - 2023-04-27

#### Changed
- Update Lucide icons to v0.181

### 1.0.5 - 2023-04-15

#### Changed
- Update Lucide icons to v0.145

### 1.0.4 - 2023-04-03

#### Changed
- Update Lucide icons to v0.129

### 1.0.3 - 2023-03-06

#### Changed
- Update Lucide icons to v0.123

### 1.0.2 - 2022-11-11

#### Changed
- Update Lucide icons to v0.100

### 1.0.1 - 2022-10-26

#### Changed
- Update Lucide icons to v0.94

### 1.0.0 - 2022-06-15

Initial release 🎉

## Recent Versions

| Version | Released |
|---|---|
| 2.3.0 | 2026-03-24 |
| 2.2.10 | 2026-01-18 |
| 2.2.9 | 2025-11-07 |
| 2.2.8 | 2025-08-02 |
| 2.2.7 | 2025-07-04 |
| 2.2.6 | 2025-06-02 |
| 2.2.5 | 2025-05-01 |
| 2.2.4 | 2025-04-07 |
| 2.2.3 | 2025-02-06 |
| 2.2.2 | 2025-01-10 |

Showing 10 of 35 versions. Full release history on https://packagento.com/siteation/magento2-hyva-icons-lucide.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| hyva-themes/magento2-theme-module | >=1.1.12 |

## Quality

Latest release (2.3.0) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | not tested | not tested | – | – |
| 2.4.8 | – | not tested | not tested | – |
| 2.4.9 | – | – | 1 | 1 |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Pass | 0 |  |
| PHPMD | Pass | 0 |  |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 2 | valid; 2 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Error | Error | – | – |
| 2.4.8 | – | Error | Error | – |
| 2.4.9 | – | – | Error | Error |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | N/A | 0 | no resolvable dependency tree to audit — Your requirements could not be resolved to an installable set of packages. Problem 1 |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["siteation/magento2-hyva-icons-lucide"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

siteation is a Magento 2 vendor on Packagento. See https://packagento.com/siteation.md for their full catalogue.