PHPackages                             blade-ui-kit/blade-heroicons - 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. [Templating &amp; Views](/categories/templating)
4. /
5. blade-ui-kit/blade-heroicons

ActiveLibrary[Templating &amp; Views](/categories/templating)

blade-ui-kit/blade-heroicons
============================

A package to easily make use of Heroicons in your Laravel Blade views.

2.7.0(2mo ago)64227.9M—0.9%5620MITPHPPHP ^8.0CI passing

Since Jun 17Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/driesvints/blade-heroicons)[ Packagist](https://packagist.org/packages/blade-ui-kit/blade-heroicons)[ Docs](https://github.com/driesvints/blade-heroicons)[ GitHub Sponsors](https://github.com/sponsors/driesvints)[ Fund](https://www.paypal.com/paypalme/driesvints)[ RSS](/packages/blade-ui-kit-blade-heroicons/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (35)Used By (20)

 [![](https://github.com/driesvints/blade-heroicons/raw/main/art/socialcard-blade-heroicons.png "Social Card Blade UI Kit")](https://github.com/driesvints/blade-heroicons/blob/main/art/socialcard-blade-heroicons.png)

Blade Heroicons
===============

[](#blade-heroicons)

[ ![Tests](https://github.com/driesvints/blade-heroicons/workflows/Tests/badge.svg)](https://github.com/driesvints/blade-heroicons/actions?query=workflow%3ATests)[ ![Coding Standards](https://github.com/driesvints/blade-heroicons/actions/workflows/coding-standards.yml/badge.svg)](https://github.com/driesvints/blade-heroicons/actions/workflows/coding-standards.yml)[ ![Latest Stable Version](https://camo.githubusercontent.com/7429b1a36229fc8ff0c5332487220ab6574e40cf51d6f8a6a9271b8806c29e14/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c6164652d75692d6b69742f626c6164652d6865726f69636f6e73)](https://packagist.org/packages/blade-ui-kit/blade-heroicons)[ ![Total Downloads](https://camo.githubusercontent.com/2287051eed46baa54044e38e0b499cb8768ef416db378d6f443f11d04ef1e2be/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c6164652d75692d6b69742f626c6164652d6865726f69636f6e73)](https://packagist.org/packages/blade-ui-kit/blade-heroicons)A package to easily make use of [Heroicons](https://github.com/refactoringui/heroicons) in your Laravel Blade views.

For a full list of available icons see [the SVG directory](resources/svg) or preview them at [heroicons.com](https://heroicons.com/). Heroicons are originally developed by [Steve Schoger](https://twitter.com/steveschoger) and [Adam Wathan](https://twitter.com/adamwathan).

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

[](#requirements)

- PHP 8.0 or higher
- Laravel 9.0 or higher

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

[](#installation)

```
composer require blade-ui-kit/blade-heroicons
```

Updating
--------

[](#updating)

Please refer to [`the upgrade guide`](UPGRADE.md) when updating the library.

Blade Icons
-----------

[](#blade-icons)

Blade Heroicons uses Blade Icons under the hood. Please refer to [the Blade Icons readme](https://github.com/driesvints/blade-icons) for additional functionality. We also recommend to [enable icon caching](https://github.com/driesvints/blade-icons#caching) with this library.

Configuration
-------------

[](#configuration)

Blade Heroicons also offers the ability to use features from Blade Icons like default classes, default attributes, etc. If you'd like to configure these, publish the `blade-heroicons.php` config file:

```
php artisan vendor:publish --tag=blade-heroicons-config
```

Usage
-----

[](#usage)

Icons can be used as self-closing Blade components which will be compiled to SVG icons:

```

```

You can also pass classes to your icon components:

```

```

And even use inline styles:

```

```

Or use the `@svg` directive:

```
@svg('heroicon-o-arrow-left', 'w-6 h-6', ['style' => 'color: #555'])
```

The solid icons can be referenced like this:

```

```

The mini icons can be referenced like this:

```

```

And the micro icons can be referenced like this:

```

```

### Raw SVG Icons

[](#raw-svg-icons)

If you want to use the raw SVG icons as assets, you can publish them using:

```
php artisan vendor:publish --tag=blade-heroicons --force
```

Then use them in your views like:

```

```

Changelog
---------

[](#changelog)

Check out the [CHANGELOG](CHANGELOG.md) in this repository for all the recent changes.

Maintainers
-----------

[](#maintainers)

Blade Heroicons is developed and maintained by [Dries Vints](https://driesvints.com).

License
-------

[](#license)

Blade Heroicons is open-sourced software licensed under [the MIT license](LICENSE.md).

###  Health Score

71

—

ExcellentBetter than 100% of packages

Maintenance87

Actively maintained with recent releases

Popularity72

Solid adoption and visibility

Community41

Growing community involvement

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 86.7% 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 ~65 days

Recently: every ~121 days

Total

33

Last Release

63d ago

Major Versions

0.3.1 → 1.0.02021-03-21

1.3.1 → 2.0.02022-08-24

1.4.0 → 2.2.02023-12-18

1.5.0 → 2.4.02024-07-16

1.x-dev → 2.7.02026-03-16

PHP version history (4 changes)0.1.0PHP ^7.2

0.3.0PHP ^7.3|^8.0

1.0.0PHP ^7.4|^8.0

2.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/21c134451d35d6aed19651f13e2abb56c1dc0eaf7d59c926534c25f072765612?d=identicon)[driesvints](/maintainers/driesvints)

---

Top Contributors

[![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (124 commits)")[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![georgeboot](https://avatars.githubusercontent.com/u/884482?v=4)](https://github.com/georgeboot "georgeboot (2 commits)")[![iksaku](https://avatars.githubusercontent.com/u/4632429?v=4)](https://github.com/iksaku "iksaku (2 commits)")[![mallardduck](https://avatars.githubusercontent.com/u/619938?v=4)](https://github.com/mallardduck "mallardduck (2 commits)")[![robsontenorio](https://avatars.githubusercontent.com/u/118955?v=4)](https://github.com/robsontenorio "robsontenorio (1 commits)")[![danharrin](https://avatars.githubusercontent.com/u/41773797?v=4)](https://github.com/danharrin "danharrin (1 commits)")[![duongtdvn](https://avatars.githubusercontent.com/u/5475366?v=4)](https://github.com/duongtdvn "duongtdvn (1 commits)")[![faustbrian](https://avatars.githubusercontent.com/u/22145591?v=4)](https://github.com/faustbrian "faustbrian (1 commits)")[![risangbaskoro](https://avatars.githubusercontent.com/u/36572342?v=4)](https://github.com/risangbaskoro "risangbaskoro (1 commits)")[![adevade](https://avatars.githubusercontent.com/u/1066486?v=4)](https://github.com/adevade "adevade (1 commits)")

---

Tags

bladeheroiconsiconslaravelsvglaravelbladeHeroicons

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/blade-ui-kit-blade-heroicons/health.svg)

```
[![Health](https://phpackages.com/badges/blade-ui-kit-blade-heroicons/health.svg)](https://phpackages.com/packages/blade-ui-kit-blade-heroicons)
```

###  Alternatives

[technikermathe/blade-lucide-icons

A package to easily make use of Lucide icons in your Laravel Blade views.

18299.2k7](/packages/technikermathe-blade-lucide-icons)[stijnvanouplines/blade-country-flags

A package to easily make use of country flags in your Laravel Blade views.

26307.2k6](/packages/stijnvanouplines-blade-country-flags)[saade/blade-iconsax

A package to easily make use of Iconsax in your Laravel Blade views.

21138.5k](/packages/saade-blade-iconsax)[mckenziearts/blade-untitledui-icons

A package to easily make use of UntitledUI icons in your Laravel Blade views.

16104.9k5](/packages/mckenziearts-blade-untitledui-icons)[afatmustafa/blade-hugeicons

A package to easily make use of Hugeicons(Free version) in your Laravel Blade views.

13129.0k3](/packages/afatmustafa-blade-hugeicons)

PHPackages © 2026

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