PHPackages                             filafly/filament-icons - 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. filafly/filament-icons

ActiveLibrary[Utility & Helpers](/categories/utility)

filafly/filament-icons
======================

Core package for managing Filament icon drivers via a common interface.

v2.2.0(2mo ago)536.7k↑56.6%58MITPHPPHP ^8.2

Since Apr 30Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/filafly/filament-icons)[ Packagist](https://packagist.org/packages/filafly/filament-icons)[ Docs](https://filafly.com/plugins/filament-icons)[ RSS](/packages/filafly-filament-icons/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (14)Used By (8)

 [![Banner](images/filament-icons.png)](images/filament-icons.png)

A package to replace Filament's default Heroicons with your preferred icon set, providing unified icon management with style variations and overrides. Features
========

[](#features)

- **Unified Icon Management**: Standardize all icons across your Filament project.
- **Style Variations**: Switch between icon styles (e.g., `solid`, `regular`, `light`) with a single method call.
- **Granular Overrides**: Override specific icons or aliases at the global or component level.
- **Extensible**: Easily create your own icon set implementations for any icon library with a Blade Icons package.
- **Developer-Focused**: Designed for developers creating icon set implementations, not just end-users.

Available Icon Sets
===================

[](#available-icon-sets)

The following icon sets are available as separate packages that work with this core package:

Official Implementations
------------------------

[](#official-implementations)

- [Phosphor](https://github.com/filafly/filament-phosphor-icons)
- [Font Awesome](https://github.com/filafly/filament-font-awesome-icons)
- [Iconoir](https://github.com/filafly/filament-iconoir-icons)
- [Carbon](https://github.com/filafly/filament-carbon-icons)
- [Hugeicons](https://github.com/filafly/filament-hugeicons-icons)

Community Implementations
-------------------------

[](#community-implementations)

- [Solar](https://github.com/W84T/filament-solar-icons) by [W84T](https://github.com/W84T)

Creating Your Own Icon Set
==========================

[](#creating-your-own-icon-set)

The best and most straightforward way to create your own set is by using the [Filament Icons Template repository](https://github.com/filafly/filament-icons-template). Just click "use this template" and follow the instructions on the page.

If you want to create your own implementation manually, this package enables you to integrate any icon library that has a Blade Icons implementation with Filament. Here's how to get started:

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

[](#requirements)

- An icon set with a [Blade Icons](https://github.com/blade-ui-kit/blade-icons) implementation. If one doesn't exist, you'll need to create it.
- Your project must use Filament v4 or v5. For older versions, use the `1.x` branch of this package.

Implementation Steps
--------------------

[](#implementation-steps)

### 1. Define the Icon Enum

[](#1-define-the-icon-enum)

Create a PHP enum that defines all icons in your set. The enum cases should have styles baked into their names (e.g., `SearchRegular`, `SearchSolid`).

```