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

ActiveLibrary

filamerce/filament-picker
=========================

A Regular Picker for Filament Form

v1.0.0(1y ago)0850↓33.3%MITPHPPHP ^8.1

Since Apr 17Pushed 10mo agoCompare

[ Source](https://github.com/filamerce/filament-picker)[ Packagist](https://packagist.org/packages/filamerce/filament-picker)[ Docs](https://github.com/filamerce/filament-picker)[ RSS](/packages/filamerce-filament-picker/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelogDependencies (3)Versions (4)Used By (0)

A Regular Picker for Filament
=============================

[](#a-regular-picker-for-filament)

[![Latest Version on Packagist](https://camo.githubusercontent.com/189ffe50923e5f12763e7470443ee060ac7ab3ddffc0df33fd8ecfa0d13a806c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696c616d657263652f66696c616d656e742d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filamerce/filament-picker)[![GitHub Tests Action Status](https://camo.githubusercontent.com/87c13df87acc16006e3af2d73841053f11d439cb5cb9e9bf9da19d6ddf1a7703/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f66696c616d657263652f66696c616d656e742d7069636b65722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/filamerce/filament-picker/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ed24e22e9948dbf58f131485a0069bd6545a8ddca8d0d1619fb76e6a665756cc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f66696c616d657263652f66696c616d656e742d7069636b65722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/filamerce/filament-picker/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/484c138d674f23bed2487b94ed195c921255500799d93b3d074e5257bd8834ba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66696c616d657263652f66696c616d656e742d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filamerce/filament-picker)

A Regular Picker for Filament v3.

Original package: [icetalker/filament-picker](https://github.com/icetalker/filament-picker)

[![image](https://raw.githubusercontent.com/filamerce/filament-picker/main/screenshots/picker-dark.png)](https://raw.githubusercontent.com/filamerce/filament-picker/main/screenshots/picker-dark.png)

[![image](https://raw.githubusercontent.com/filamerce/filament-picker/main/screenshots/picker-light.png)](https://raw.githubusercontent.com/filamerce/filament-picker/main/screenshots/picker-light.png)

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

[](#installation)

You can install the package via composer:

```
composer require filamerce/filament-picker
```

Optionally, you can publish the views using

```
php artisan vendor:publish --tag="filament-picker-view"
```

Usage
-----

[](#usage)

```
public function form(Form $form): Form
{
    return $form
        ->schema([

            Picker::make('transport')
                ->label('Transport')
                ->options([
                    'ship' => 'By Sea',
                    'airplane' => 'By Air',
                    'truck' => 'By Truck',
                ])
                ->icons([
                    'ship' => 'heroicon-o-home',
                    'airplane' => 'heroicon-o-paper-airplane',
                    'truck' => 'heroicon-o-truck',
                ])
                ->imageSize(100)
                ->images([
                    'ship' => 'https://source.unsplash.com/random/100x100/?ship',
                    'airplane' => 'https://source.unsplash.com/random/100x100/?airplane',
                    'truck' => 'https://source.unsplash.com/random/100x100?truck',
                ])
                ->default('ship'),
        ]);
}
```

### Define Options

[](#define-options)

To define options, you can use the `options()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the label to be displayed.

```
Picker::make('transport')
    ->options([
        'ship' => 'By Sea',
        'airplane' => 'By Air',
        'truck' => 'By Truck',
    ]);
```

### Add Icons

[](#add-icons)

To add icons, you can use the `icons()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the icon to be displayed:

```
Picker::make('transport')
    ->label('Transport')
    ->options([
        'ship' => 'By Sea',
        'airplane' => 'By Air',
        'truck' => 'By Truck',
    ])
    ->icons([
        'ship' => 'heroicon-o-home',
        'airplane' => 'heroicon-o-paper-airplane',
        'truck' => 'heroicon-o-truck',
    ])
```

### Add Images

[](#add-images)

To add images, you can use the `images()` method and pass an array of key-value pairs. The key will be the value of the option, and the value will be the image url to be displayed:

```
Picker::make('transport')
    ->label('Transport')
    ->options([
        'ship' => 'By Sea',
        'airplane' => 'By Air',
        'truck' => 'By Truck',
    ])
    ->images([
        'ship' => 'https://source.unsplash.com/random/100x100/?ship',
        'airplane' => 'https://source.unsplash.com/random/100x100/?airplane',
        'truck' => 'https://source.unsplash.com/random/100x100?truck',
    ]);
```

The size of images is 50x50 by default, you can custom the size of images by using the `imageSize()` method and pass the size in pixels.

### Default Value

[](#default-value)

To set a default value, you can use the `default()` method and pass the value of the option:

```
Picker::make('transport')
    ->label('Transport')
    ->options([
        'ship' => 'By Sea',
        'airplane' => 'By Air',
        'truck' => 'By Truck',
    ])
    ->default('ship');
```

Todo
----

[](#todo)

- Add Relationship Support
- Add Validation

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

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

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Martin H](https://github.com/icetalker)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance50

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~34 days

Total

3

Last Release

329d ago

Major Versions

1.x-dev → 2.x-dev2025-06-23

### Community

Maintainers

![](https://www.gravatar.com/avatar/e34f6439ff69a5e372136c97bf9166d48010bfa7dd29af729e8a6db98d58335d?d=identicon)[webard](/maintainers/webard)

---

Top Contributors

[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (8 commits)")[![icetalker](https://avatars.githubusercontent.com/u/106749492?v=4)](https://github.com/icetalker "icetalker (5 commits)")[![DiogoRCP](https://avatars.githubusercontent.com/u/14082205?v=4)](https://github.com/DiogoRCP "DiogoRCP (4 commits)")[![tubring](https://avatars.githubusercontent.com/u/46536059?v=4)](https://github.com/tubring "tubring (3 commits)")[![arie-piscator](https://avatars.githubusercontent.com/u/9989186?v=4)](https://github.com/arie-piscator "arie-piscator (1 commits)")[![bytexr](https://avatars.githubusercontent.com/u/129063632?v=4)](https://github.com/bytexr "bytexr (1 commits)")

---

Tags

laravelicetalkerfilament-picker

### Embed Badge

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

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

###  Alternatives

[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

320392.1k17](/packages/codewithdennis-filament-select-tree)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)[ralphjsmit/laravel-filament-components

A collection of reusable components for Filament.

10972.2k2](/packages/ralphjsmit-laravel-filament-components)[rawilk/filament-password-input

Enhanced password input component for filament.

52232.4k3](/packages/rawilk-filament-password-input)[icetalker/filament-picker

A Regular Picker for Filament Form

1052.8k](/packages/icetalker-filament-picker)

PHPackages © 2026

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