filafly/phosphor-icon-replacement

Replace the default Filament icons with Phosphor icons.

v1.0.1 2025-02-04 23:01 UTC

Requires

• php: ^8.1
• codeat3/blade-phosphor-icons: ^2.2
• filament/filament: ^3.2.3
• illuminate/support: *
• spatie/laravel-package-tools: ^1.9

Requires (Dev)

• laravel/pint: ^1.20

MIT

• Nolan Nordlund

• laravel
• icons
• replace
• filament
• Phosphor

README

Tired of Heroicons? Quickly swap out all icons used by the Filament framework with Phosphor icons. Include support for 6 different icon styles.

Requirements

• PHP 8.1+
• Filament v3.2+

Installation

There are only two steps to install Phosphor Icon Replacement. First, you need to install the package via composer:

composer require filafly/phosphor-icon-replacement

Secondly, add the plugin to any panels you wish:

->plugin(\Filafly\PhosphorIconReplacement::make())

Screenshots

Usage

Setting a default style

All 6 Phosphor icon styles are available and can be used by simply calling the style name as a method on the plugin:

PhosphorIconReplacement::make()->thin()
PhosphorIconReplacement::make()->light()
PhosphorIconReplacement::make()->regular()
PhosphorIconReplacement::make()->bold()
PhosphorIconReplacement::make()->fill()
PhosphorIconReplacement::make()->duotone()

If no style is explicitly chosen, regular will be used.

Override Specific Icons

If you need to override certain icons to use a different style, you can use either icon aliases or direct icon names.

Using Icon Aliases

Use the overrideStyleForAlias method with a Filament Icon Alias. This method works with either a single icon key (string) or multiple icon keys (array).

// Override a single icon key
PhosphorIconReplacement::overrideStyleForAlias('tables::actions.filter', 'thin');

// Override multiple icon keys at once
PhosphorIconReplacement::overrideStyleForAlias([
    'tables::actions.filter',
    'actions::delete-action',
], 'thin');

Using Icon Names

Use the overrideStyleForIcon method with the actual Phosphor icon name. Like the alias method, this works with either a single icon name or multiple names.

// Override a single icon
PhosphorIconReplacement::overrideStyleForIcon('phosphor-user', 'thin');

// Override multiple icons at once
PhosphorIconReplacement::overrideStyleForIcon([
    'phosphor-user',
    'phosphor-caret-up',
    'phosphor-bell',
], 'thin');

License

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