PHPackages                             psyao/filament-icon-picker - 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. psyao/filament-icon-picker

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

psyao/filament-icon-picker
==========================

A Filament form field that provides a searchable icon picker backed by Blade UI Icons manifests.

1.0.0(5mo ago)06[2 PRs](https://github.com/psyao/filament-icon-picker/pulls)MITPHPPHP ^8.2CI passing

Since Nov 29Pushed 1mo agoCompare

[ Source](https://github.com/psyao/filament-icon-picker)[ Packagist](https://packagist.org/packages/psyao/filament-icon-picker)[ Docs](https://github.com/psyao/filament-icon-picker)[ GitHub Sponsors](https://github.com/sponsors/psyao)[ RSS](/packages/psyao-filament-icon-picker/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (15)Versions (6)Used By (0)

Filament Icon Picker
====================

[](#filament-icon-picker)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c4b58f45e5f60553a515ff660e01256bbff04210bfbf0fd3570f5b185bb8a3ad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707379616f2f66696c616d656e742d69636f6e2d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/psyao/filament-icon-picker)[![GitHub Tests Action Status](https://camo.githubusercontent.com/0fba8f2299843b49c0e9efd56b8041012614ed377c140cff831f6e194a393882/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f707379616f2f66696c616d656e742d69636f6e2d7069636b65722f72756e2d74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/psyao/filament-icon-picker/actions?query=workflow%3Arun-tests+branch%3Amaster)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/cfda2ab4e95bd8c653a4c6c5597c80a8e5b6914dfe6a111854a37d60d25f69b9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f707379616f2f66696c616d656e742d69636f6e2d7069636b65722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d6173746572266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/psyao/filament-icon-picker/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/a9e38104106d0f75f7ba0367377fbd4c6d7f038c7df5f58473eece53136d2f82/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f707379616f2f66696c616d656e742d69636f6e2d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/psyao/filament-icon-picker)

A Filament form field that provides a searchable icon picker backed by [Blade UI Icons](https://blade-ui-kit.com/docs/icons/introduction).

By default, [Filament](https://filamentphp.com/docs/4.x/styling/icons) includes Heroicons out of the box. This package makes it easy to surface additional icon sets (registered with Blade Icons) in a modal picker.

Notes

- `IconPicker` extends Filament's `ModalTableSelect` and customizes selection and preview behavior.
- Prefer the `IconPicker` API for configuration and usage — calling `ModalTableSelect` methods directly may break selection, styling, or the live preview.

Table of contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
    - [Forms](#in-forms)
    - [Tables](#in-tables)
    - [Infolists](#in-infolists)
    - [Blade views](#in-blade-views)
- [Testing](#testing)
- [Changelog](#changelog)
- [Contributing](#contributing)
- [Security Vulnerabilities](#security-vulnerabilities)
- [Credits](#credits)
- [License](#license)

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

[](#requirements)

- PHP ^8.2
- Filament 4.x

Features
--------

[](#features)

- Modal picker with a searchable table of icons
- Live preview of the selected icon
- Filter available icon sets
- Simple integration with Filament forms, tables and infolists

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

[](#installation)

Install via Composer:

```
composer require psyao/filament-icon-picker
```

Usage
-----

[](#usage)

### In forms

[](#in-forms)

Use the `IconPicker` field inside your Filament form schema. The field opens a modal table that lets users pick an icon and renders a live preview automatically.

Basic example:

```
use Psyao\FilamentIconPicker\Forms\IconPicker;

IconPicker::make('icon')
```

Limit available sets:

```
IconPicker::make('icon')
    ->sets(['lucide', 'simple-icons'])
```

Show labels under icons in the picker:

```
IconPicker::make('icon')
    ->showIconLabels()
```

### In tables

[](#in-tables)

To display the selected icon in a Filament table, use `IconColumn`:

```
use Filament\Tables\Columns\IconColumn;

IconColumn::make('icon')
    ->icon(fn ($state) => $state))
```

### In infolists

[](#in-infolists)

To display the selected icon in an infolist, use `IconEntry`:

```
use Filament\Infolists\Components\IconEntry;

IconEntry::make('status')
    ->icon(fn ($state) => $state))
```

### In Blade views

[](#in-blade-views)

Render the selected icon in Blade (depending on your Blade Icons helper):

```
@svg($icon, ['class' => 'h-5 w-5'])

{{ svg($icon, ['class' => 'h-5 w-5']) }}
```

Testing
-------

[](#testing)

Run the test suite with:

```
composer test
```

Changelog
---------

[](#changelog)

See [CHANGELOG](CHANGELOG.md) for recent changes.

Contributing
------------

[](#contributing)

See [CONTRIBUTING](.github/CONTRIBUTING.md) for contribution guidelines.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) for reporting vulnerabilities.

Credits
-------

[](#credits)

- [Steve Aguet](https://github.com/psyao)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). See [LICENSE.md](LICENSE.md) for details.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance83

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

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

Every ~1 days

Total

3

Last Release

161d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9dcbc5fc2a682a6cc0efb8477064579fece78163453b5e1efbf100130a22c94e?d=identicon)[psyao](/maintainers/psyao)

---

Top Contributors

[![psyao](https://avatars.githubusercontent.com/u/845391?v=4)](https://github.com/psyao "psyao (40 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laraveliconfilamenticon-pickerblade-iconsfilament-icon-pickerfilament-formBlade UI Kitfilament fieldpsyao

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/psyao-filament-icon-picker/health.svg)

```
[![Health](https://phpackages.com/badges/psyao-filament-icon-picker/health.svg)](https://phpackages.com/packages/psyao-filament-icon-picker)
```

###  Alternatives

[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[wallacemartinss/filament-icon-picker

A beautiful icon picker component for Filament v5 using blade-ui-kit/blade-icons

467.1k17](/packages/wallacemartinss-filament-icon-picker)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[aymanalhattami/filament-context-menu

context menu (right click menu) for filament

9838.0k](/packages/aymanalhattami-filament-context-menu)

PHPackages © 2026

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