Search by

filafly / filament-bootstrap-icons

filafly

Bootstrap Icons pack for Filament Icons: replaces every Filament UI icon with Bootstrap Icons, outline or fill

Package info

github.com/filafly/filament-bootstrap-icons

Homepage

pkg:composer/filafly/filament-bootstrap-icons

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-11-15 15:15 UTC

This package is auto-updated.

Last update: 2026-11-15 15:19:01 UTC


README

A Filament panel using Bootstrap Icons

Filament Bootstrap Icons

A Bootstrap Icons set for Filament Icons. Register one plugin and every icon in Filament's own UI (sidebar, tables, forms, actions, notifications, the rich editor toolbar, multi-factor auth and the rest) switches to Bootstrap Icons, in regular or fill style. All 2,078 Bootstrap icons are also available as an enum for your own resources.

Works with Filament 4 and 5.

More about this package on FilaFly: Bootstrap Icons for Filament on FilaFly.

Installation

You can install the package via composer:

composer require filafly/filament-bootstrap-icons

Not sure which Laravel and PHP versions your Filament version needs? See the Filament version compatibility guide.

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

use Filafly\Icons\Bootstrap\BootstrapIcons;

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

That's it. Every Filament icon alias (all 223 in Filament 5) is mapped to a Bootstrap icon.

Setting the global icon style

Bootstrap Icons come in two styles:

  • Regular (default)
  • Fill
BootstrapIcons::make()->regular(); // (default)
BootstrapIcons::make()->fill();

Only icons that Bootstrap draws in both styles switch. Chevrons, the close cross, the search glass and the editor toolbar icons, for example, have no fill version and stay the same.

Setting style for a subset of icons

If you need some icons in a different style, you can use either icon aliases or icon enum cases.

Using icon aliases

Use the overrideStyleForAlias method with a Filament Icon Alias. It takes a single alias or an array of aliases.

use Filafly\Icons\Bootstrap\BootstrapIcons;
use Filafly\Icons\Bootstrap\Enums\BootstrapStyle;
use Filament\Tables\View\TablesIconAlias;
use Filament\Actions\View\ActionsIconAlias;

// Override a single alias
BootstrapIcons::make()->overrideStyleForAlias(TablesIconAlias::ACTIONS_FILTER, BootstrapStyle::Fill);

// Override several aliases at once
BootstrapIcons::make()->overrideStyleForAlias([
    TablesIconAlias::ACTIONS_FILTER,
    ActionsIconAlias::DELETE_ACTION,
], BootstrapStyle::Fill);

Using icon enum cases

Use the overrideStyleForIcon method with Bootstrap enum case(s). Like the alias method, it takes a single case or an array.

use Filafly\Icons\Bootstrap\BootstrapIcons;
use Filafly\Icons\Bootstrap\Enums\Bootstrap;
use Filafly\Icons\Bootstrap\Enums\BootstrapStyle;

// Override a single icon
BootstrapIcons::make()->overrideStyleForIcon(Bootstrap::Trash, BootstrapStyle::Fill);

// Override several icons at once
BootstrapIcons::make()->overrideStyleForIcon([
    Bootstrap::Trash,
    Bootstrap::Funnel,
], BootstrapStyle::Fill);

Specifying exact icons to use

You can also specify exactly which icon you would like to use in given situations. This can be done via icon aliases or icon enum cases.

Override icon aliases

Use overrideAlias() to change which icon is used for specific Filament icon aliases:

use Filafly\Icons\Bootstrap\BootstrapIcons;
use Filafly\Icons\Bootstrap\Enums\Bootstrap;
use Filament\View\PanelsIconAlias;
use Filament\Tables\View\TablesIconAlias;

BootstrapIcons::make()
    ->overrideAlias(PanelsIconAlias::SIDEBAR_EXPAND_BUTTON, Bootstrap::ChevronDoubleRight)
    ->overrideAlias(TablesIconAlias::ACTIONS_FILTER, Bootstrap::Filter);

Or use overrideAliases() to override multiple aliases at once by passing an array:

BootstrapIcons::make()
    ->overrideAliases([
        PanelsIconAlias::SIDEBAR_EXPAND_BUTTON => Bootstrap::ChevronDoubleRight,
        TablesIconAlias::ACTIONS_FILTER => Bootstrap::Filter,
    ]);

Override individual icons

Use overrideIcon() to replace a Bootstrap icon everywhere this pack uses it:

BootstrapIcons::make()
    ->overrideIcon(Bootstrap::Trash, Bootstrap::Trash3)
    ->overrideIcon(Bootstrap::PencilSquare, Bootstrap::Pencil);

Or use overrideIcons() to override multiple icons at once by passing an array:

BootstrapIcons::make()
    ->overrideIcons([
        Bootstrap::Trash->value => Bootstrap::Trash3,
        Bootstrap::PencilSquare->value => Bootstrap::Pencil,
    ]);

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

Exact overrides win over styles, so pick the regular or fill case you want.

Icon enum

All Bootstrap icons are available through an enum providing convenient usage throughout Filament. For more information, check the Filament docs.

use Filament\Forms\Components\Toggle;
use Filafly\Icons\Bootstrap\Enums\Bootstrap;

Toggle::make('is_starred')
    ->onIcon(Bootstrap::StarFill)

The icons come from davidhsianturi/blade-bootstrap-icons, so <x-bi-star /> and @svg('bi-star') work in your own Blade views too.

Testing

composer test

The suite checks that every icon alias in the installed Filament version is mapped, that every enum case has an SVG, and that fill() switches every icon that has a fill version.

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 for more information. This package contains no icon files: the icons are installed by davidhsianturi/blade-bootstrap-icons.

Bootstrap Icons are © The Bootstrap Authors under the MIT License.