PHPackages stefangalescu/statamic-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 & Views](/categories/templating) 4. / 5. stefangalescu/statamic-heroicons ActiveLibrary[Templating & Views](/categories/templating) stefangalescu/statamic-heroicons ================================ Use and easily customize Heroicons in your Statamic templates v3.2(4mo ago)224.9k↓18.6%6[1 PRs](https://github.com/stefangalescu/statamic-heroicons/pulls)MITPHPPHP ^8.1 || ^8.2 || ^8.3 || ^8.4 || ^8.5CI passing Since Jun 20Pushed 4mo ago1 watchersCompare [ Source](https://github.com/stefangalescu/statamic-heroicons)[ Packagist](https://packagist.org/packages/stefangalescu/statamic-heroicons)[ RSS](/packages/stefangalescu-statamic-heroicons/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (5)Versions (12)Used By (0) [![Banner](banner.jpg)](banner.jpg) Statamic Heroicons ================== [](#statamic-heroicons) A package to easily make use of Heroicons in your Statamic sites. This package is a wrapper over [`blade-ui-kit/blade-heroicons`](https://github.com/blade-ui-kit/blade-heroicons). For a full list of available icons see [the SVG directory](https://github.com/blade-ui-kit/blade-heroicons/tree/main/resources/svg) from the [`blade-ui-kit/blade-heroicons`](https://github.com/blade-ui-kit/blade-heroicons) repository 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). If you're looking to use Heroicons v1, please use the v1 version of the package. Requirements ------------ [](#requirements) - PHP 8.1 or higher - Laravel 10.0 or higher - Statamic 3.4 or higher Apart from the requirements above, it is required that you use Statamic's new Runtime Antlers engine. Read more about it and how to enable it in [Statamic's official documentation](https://statamic.dev/new-antlers-parser#about). Documentation ------------- [](#documentation) ### Installation [](#installation) First, require `statamic-heroicons` as a Composer dependency: ``` composer require stefangalescu/statamic-heroicons ``` If you need additional options, you can publish the [`blade-ui-kit/blade-heroicons`](https://github.com/blade-ui-kit/blade-heroicons) config. Make sure to also look into the [icon caching](https://github.com/blade-ui-kit/blade-icons#caching) feature provided by [`blade-ui-kit/blade-heroicons`](https://github.com/blade-ui-kit/blade-heroicons). ### Usage [](#usage) ``` {{ heroicon:mini:bars-3 }} {{ heroicon:solid:bars-3 }} {{ heroicon:outline:bars-3 }} {{ heroicon:outline:bars-3 class="text-gray-500" }} {{ heroicon :variant="variant" :icon="icon" }} ``` Apart from a couple of reserved prop names (`as`, `scope`, `variant`, `icon`), any prop you pass (e.g. `class`, `style`, `aria-hidden` etc.) to the tag will be added to the root SVG element. The `{{ heroicon }}` tag also allows you to pass dynamically binded attributes like you would use in a JavaScript framework like Alpine.js. The only gotcha is that you cannot use the shorthand syntax `:class="condition ? 'text-red-500' : 'text-green-500'"`. You must use the full binding (e.g. `x-bind:class`, `v-bind:class`). Example: ``` {{ heroicon:solid:bars-3 class="w-5 h-5" title="Main menu" }} {{ heroicon:solid:bars-3 class="w-5 h-5" x-bind:class="condition ? 'text-red-500' : 'text-green-500'" }} ``` ### Testing [](#testing) ``` composer test ``` Security -------- [](#security) Only the latest version of `statamic-heroicons` will receive security updates if a vulnerability is found. If you discover a security vulnerability, please report it to Stefan Galescu straight away, [via email](mailto:stefan.galescu@gmail.com). Please don't report security issues through GitHub Issues. Sponsor Stefan -------------- [](#sponsor-stefan) This addon is open-source, meaning anyone can use this addon in their sites for **free**! However, maintaining and developing new features for open-source projects can take quite a bit of time. If you're using `statamic-heroicons` in your production environment, please [consider sponsoring me](https://github.com/sponsors/stefangalescu) for however you consider to be a fair amount. ### Health Score 53 — FairBetter than 97% of packages Maintenance77 Regular maintenance activity Popularity33 Limited adoption so far Community12 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 97.4% 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 ~130 days Recently: every ~244 days Total 11 Last Release 127d ago Major Versions v1.1 → v2.02023-02-18 v2.1.1 → v3.02024-05-17 PHP version history (5 changes)v1.0.0PHP ^7.4 || ^8.0 || ^8.1 v2.0PHP ^8.1 || ^8.2 v3.0PHP ^8.1 || ^8.2 || ^8.3 v3.1PHP ^8.1 || ^8.2 || ^8.3 || ^8.4 v3.2PHP ^8.1 || ^8.2 || ^8.3 || ^8.4 || ^8.5 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/52995748?v=4)[Stefan Galescu](/maintainers/stefangalescu)[@stefangalescu](https://github.com/stefangalescu) --- Top Contributors [![stefangalescu](https://avatars.githubusercontent.com/u/52995748?v=4)](https://github.com/stefangalescu "stefangalescu (37 commits)")[![stefan-galescu-ptt](https://avatars.githubusercontent.com/u/103926389?v=4)](https://github.com/stefan-galescu-ptt "stefan-galescu-ptt (1 commits)") --- Tags heroiconsiconsphpstatamicstatamic-addonstatamic-v4statamic-v5 ### Code Quality Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/stefangalescu-statamic-heroicons/health.svg) ``` [![Health](https://phpackages.com/badges/stefangalescu-statamic-heroicons/health.svg)](https://phpackages.com/packages/stefangalescu-statamic-heroicons) ``` ### Alternatives [robsontenorio/mary Gorgeous UI components for Livewire powered by daisyUI and Tailwind 1.5k454.7k15](/packages/robsontenorio-mary)[developermithu/tallcraftui TallCraftUI is a Laravel blade UI components library built on TALL stack 1672.4k](/packages/developermithu-tallcraftui)[statamic-rad-pack/runway Eloquently manage your database models in Statamic. 135192.6k5](/packages/statamic-rad-pack-runway)[stillat/antlers-components 2656.0k1](/packages/stillat-antlers-components)[tomatophp/tomato-admin Tomato Admin Dashboard Build With FilamentPHP Theme for Laravel Splade 578.6k60](/packages/tomatophp-tomato-admin)[ddfsn/blade-components Blade Components is a hand-crafted, UI component library for building consistent web experiences in Laravel apps. 193.1k](/packages/ddfsn-blade-components) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)