filafly / filament-hugeicons-icons

v1.2.0 2026-10-30 21:22 UTC

Requires

• php: ^8.2
• afatmustafa/blade-hugeicons: ^1.0 || ^2.0
• filafly/filament-icons: ^2.0
• filament/filament: ^4.0 || ^5.0

Requires (Dev)

• laravel/pint: ^1.22

MIT

• Nolan Nordlund

• laravel
• icons
• replace
• swap
• filament
• Hugeicons

Published on Packagist.org on 2026-10-30 21:23 UTC

README

Filament Hugeicons Icons

A Hugeicons icon set implementation for Filament Icons, allowing for instant replacement of all icons used within the Filament framework.

More about this package on FilaFly: Hugeicons icons for Filament on FilaFly.

Installation

You can install the package via composer:

composer require filafly/filament-hugeicons-icons

After the package is installed, you must register the plugin in your Filament Panel provider:

use Filafly\Icons\Hugeicons\HugeiconsIcons;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(HugeiconsIcons::make());
}

Overriding individual icons

You can change which icon is used for any given Filament alias:

Using icon aliases

use Filafly\Icons\Hugeicons\HugeiconsIcons;
use Filafly\Icons\Hugeicons\Enums\Hugeicons;
use Filament\Tables\View\TablesIconAlias;
use Filament\View\PanelsIconAlias;

// Override a single alias
HugeiconsIcons::make()->overrideAlias(TablesIconAlias::ACTIONS_FILTER, Hugeicons::FilterHorizontal);

// Override multiple aliases at once
HugeiconsIcons::make()->overrideAliases([
    TablesIconAlias::ACTIONS_FILTER => Hugeicons::FilterHorizontal,
    PanelsIconAlias::GLOBAL_SEARCH_FIELD => Hugeicons::Search02,
]);

Using icon enum cases

use Filafly\Icons\Hugeicons\HugeiconsIcons;
use Filafly\Icons\Hugeicons\Enums\Hugeicons;

// Replace every instance of one icon with another
HugeiconsIcons::make()->overrideIcon(Hugeicons::User, Hugeicons::UserCircle);

// Replace multiple icons at once
HugeiconsIcons::make()->overrideIcons([
    Hugeicons::User->value => Hugeicons::UserCircle,
    Hugeicons::Search01->value => Hugeicons::Search02,
]);

PHP arrays do not support enums as keys so ->value is necessary if you want to reference the enum

Credits

• Hugeicons for the icon library
• Filament Icons for the base icon system

From FilaFly

FilaFly also makes premium themes for Filament panels: Lucent, Prizm, Cypher and Citrus. Browse the themes.

License

The MIT License (MIT). Please see License File for more information.