PHPackages                             xbirdfr/ux-icons-alias-bundle - 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. xbirdfr/ux-icons-alias-bundle

Abandoned → [symfony/ux-icons](/?search=symfony%2Fux-icons)ArchivedSymfony-bundle[Utility & Helpers](/categories/utility)

xbirdfr/ux-icons-alias-bundle
=============================

A Bundle that provides alias for Symfony UX Icons

1.0.2(1y ago)210MITPHPPHP >=8.2

Since Aug 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Xbirdfr/ux-icons-alias-bundle)[ Packagist](https://packagist.org/packages/xbirdfr/ux-icons-alias-bundle)[ Docs](https://github.com/Xbirdfr/ux-icons-alias-bundle)[ RSS](/packages/xbirdfr-ux-icons-alias-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (1)Used By (0)

UX Icons Alias Bundle
=====================

[](#ux-icons-alias-bundle)

**⚠️ NOTE:** *This repository is no longer maintained, as Symfony UX now provides a more robust solution for handling icon aliases.*
For more details, please refer to the alias system in the [Symfony UX documentation](https://symfony.com/bundles/ux-icons/current/index.html).

---

This bundle provides an alias system for [Symfony UX Icons](https://ux.symfony.com/icons).

It adds a Twig function on top of the `IconRendererInterface` introduced in version 2.19 of [symfony/ux-icons](https://github.com/symfony/ux-icons).

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

[](#installation)

Make sure Composer is installed globally, as explained in the [installation chapter](https://getcomposer.org/doc/00-intro.md) of the Composer documentation.

### Applications Using Symfony Flex

[](#applications-using-symfony-flex)

Open a terminal, navigate to your project directory, and run the following command:

```
composer require xbirdfr/ux-icons-alias-bundle

```

### Applications Not Using Symfony Flex

[](#applications-not-using-symfony-flex)

#### Step 1: Download the Bundle

[](#step-1-download-the-bundle)

Open a terminal, navigate to your project directory, and run the following command to download the latest stable version of this bundle:

```
composer require xbirdfr/ux-icons-alias-bundle

```

#### Step 2: Enable the Bundle

[](#step-2-enable-the-bundle)

Then, enable the bundle by adding it to the list of registered bundles in your project's `config/bundles.php` file:

```
// config/bundles.php

return [
    // ...
    Xbird\UxIconsAliasBundle\UxIconsAliasBundle::class => ['all' => true],
];
```

Usage
-----

[](#usage)

### Step 1: Create the Configuration File

[](#step-1-create-the-configuration-file)

Create the `ux_icons_alias.yaml` file in the `config/packages` directory:

```
# config/packages/ux_icons_alias.yaml
ux_icons_alias:
  alias:
```

### Step 2: Create an Alias

[](#step-2-create-an-alias)

Create your first alias by adding a "key: icon-name" pair to the `alias` array:

```
# config/packages/ux_icons_alias.yaml
ux_icons_alias:
  alias:
    home: material-symbols:home
```

Don't forget to clear the cache, unless your alias will not show up

```
php bin/console cache:clear

```

### Step 3: Use Your New Alias

[](#step-3-use-your-new-alias)

In a Twig template, use the `ux_icon_alias` function to display your aliased icon:

```
{{ ux_icon_alias('alias', { attributes }) }}
```

```
{# In a Twig template #}

    {{ ux_icon_alias('home') }}

    {{ ux_icon_alias('home', {class: 'w-4 h-4'}) }}

```

### One More Thing

[](#one-more-thing)

This bundle is built on top of the [symfony/ux-icons](https://github.com/symfony/ux-icons) bundle.

When called, the bundle checks if the alias exists in the configuration. If it does, the corresponding value is passed to `ux-icons`. If the alias does not exist, the alias name itself is passed to `ux-icons`.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

640d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c6f51b4288b46c414129ce5881c0b6c5a8574f06667c6274fe5077253b30c04a?d=identicon)[Xbird](/maintainers/Xbird)

---

Top Contributors

[![Xbirdfr](https://avatars.githubusercontent.com/u/6831298?v=4)](https://github.com/Xbirdfr "Xbirdfr (12 commits)")

### Embed Badge

![Health badge](/badges/xbirdfr-ux-icons-alias-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/xbirdfr-ux-icons-alias-bundle/health.svg)](https://phpackages.com/packages/xbirdfr-ux-icons-alias-bundle)
```

###  Alternatives

[bennettstone/magicmin

MagicMin is a PHP based javascript and stylesheet minification and merging class designed to generate minified, merged, and automatically updating files to simplify the process of minified file usage and updating when going between production and development environments.

495.4k](/packages/bennettstone-magicmin)

PHPackages © 2026

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