PHPackages                             husamhammad/voyager-bootstrap-icons-field - 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. husamhammad/voyager-bootstrap-icons-field

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

husamhammad/voyager-bootstrap-icons-field
=========================================

Bootstrap Icons picker FormField for Voyager with zero-config + optional one-shot installer.

v1.0.0(7mo ago)01MITBladePHP >=8.0

Since Oct 9Pushed 7mo agoCompare

[ Source](https://github.com/husamhammadcom/voyager-bootstrap-icons-field)[ Packagist](https://packagist.org/packages/husamhammad/voyager-bootstrap-icons-field)[ RSS](/packages/husamhammad-voyager-bootstrap-icons-field/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Voyager Bootstrap Icons Field
=============================

[](#voyager-bootstrap-icons-field)

A **Bootstrap Icons picker** custom FormField for [Voyager](https://github.com/the-control-group/voyager) (Laravel Admin).
Provides a clean modal UI with search, preview, and full integration in BREAD.

---

---

📸 Screenshots
-------------

[](#-screenshots)

Here are some previews of the icon picker inside Voyager BREAD:

 [![Icon Picker Modal](screenshots/modal-picker.png)](screenshots/modal-picker.png)

 [![Browse View Example](screenshots/browse-view.png)](screenshots/browse-view.png)

✨ Features
----------

[](#-features)

- Zero-config auto-discovery (Laravel 8/9/10/11).
- Bootstrap Icons modal picker with **live search** and **preview**.
- Ships with `icons.json` ready-to-use (no extra steps).
- RTL friendly (Arabic, Persian, etc).
- Optional one-shot installer to auto-wire local provider if needed.
- Supports Browse/Read display via custom view.

---

🚀 Installation
--------------

[](#-installation)

```
composer require husamhammad/voyager-bootstrap-icons-field
```

> Optional: publish assets if you want to overwrite `icons.json`:

```
php artisan vendor:publish --tag=public --force
```

---

⚙️ One-shot Installer (optional)
--------------------------------

[](#️-one-shot-installer-optional)

If `icon` field type does not appear in BREAD automatically, run:

```
php artisan voyager:icon-field:install
```

This will:

- Create `app/Providers/VoyagerFormFieldsServiceProvider.php` (if missing).
- Register it in `config/app.php`.
- Ensure `public/vendor/bootstrap-icons/icons.json` exists.
- Clear caches.

---

✅ Verify installation
---------------------

[](#-verify-installation)

```
php artisan voyager:icon-field:test
```

Expected output:

```
View loaded: YES
Class autoload: YES
icons.json present: YES

```

---

🔧 Usage in BREAD
----------------

[](#-usage-in-bread)

1. Add a `VARCHAR` column to your table, e.g. `icon`.
2. In Voyager BREAD, set **Type = icon**.
3. (Optional) For Browse/Read view, add this in **Details**: ```
    { "view": "voyager-icon-field::formfields.icon-display" }
    ```

Now you can pick an icon in Add/Edit forms and display it in Browse/Read.

---

🖼 Example in Blade
------------------

[](#-example-in-blade)

```

```

---

📝 License
---------

[](#-license)

MIT © [Husam Hammad](https://github.com/husamhammad)

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance65

Regular maintenance activity

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

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

Unknown

Total

1

Last Release

215d ago

### Community

Maintainers

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

---

Top Contributors

[![husamhammadcom](https://avatars.githubusercontent.com/u/85784207?v=4)](https://github.com/husamhammadcom "husamhammadcom (2 commits)")

---

Tags

laravelbreadformfieldicon-pickerBootstrap Iconsvoyager

### Embed Badge

![Health badge](/badges/husamhammad-voyager-bootstrap-icons-field/health.svg)

```
[![Health](https://phpackages.com/badges/husamhammad-voyager-bootstrap-icons-field/health.svg)](https://phpackages.com/packages/husamhammad-voyager-bootstrap-icons-field)
```

###  Alternatives

[larapack/voyager-hooks

Hooks integrated in Voyager

2031.5M28](/packages/larapack-voyager-hooks)[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)

PHPackages © 2026

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