PHPackages owenvoke/blade-fontawesome - 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. owenvoke/blade-fontawesome ActiveLibrary[Templating & Views](/categories/templating) owenvoke/blade-fontawesome ========================== A package to easily make use of Font Awesome in your Laravel Blade views v3.2.2(2mo ago)2083.1M—5.3%34[3 issues](https://github.com/owenvoke/blade-fontawesome/issues)[1 PRs](https://github.com/owenvoke/blade-fontawesome/pulls)20MITPHPPHP ^8.3CI passing Since Jun 23Pushed 2mo ago4 watchersCompare [ Source](https://github.com/owenvoke/blade-fontawesome)[ Packagist](https://packagist.org/packages/owenvoke/blade-fontawesome)[ Fund](https://ecologi.com/owenvoke?gift-trees)[ GitHub Sponsors](https://github.com/owenvoke)[ RSS](/packages/owenvoke-blade-fontawesome/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (14)Versions (35)Used By (20) Blade Font Awesome ================== [](#blade-font-awesome) [![Latest Version on Packagist](https://camo.githubusercontent.com/ea9777c2287c5587aca5b4c3b294dc589d950a23c152625de8aafa0ed521f826/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f77656e766f6b652f626c6164652d666f6e74617765736f6d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/owenvoke/blade-fontawesome)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/6b1c29e328ada14e5524391a8199964d1f169f1bb665862179a261212ef7c2f9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f77656e766f6b652f626c6164652d666f6e74617765736f6d652f74657374732e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d5465737473)](https://github.com/owenvoke/blade-fontawesome/actions)[![Static Analysis](https://camo.githubusercontent.com/6032d0041791b30b21edcdf623eb3f6441a8811f470fd9b8acc6e3e32ea5944d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f77656e766f6b652f626c6164652d666f6e74617765736f6d652f7374617469632e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d537461746963253230416e616c79736973)](https://github.com/owenvoke/blade-fontawesome/actions/workflows/static.yml)[![Total Downloads](https://camo.githubusercontent.com/ff5235ed349d2c686fd898595507c220088969b47d4c47bc45af709fd8bd0aa9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f77656e766f6b652f626c6164652d666f6e74617765736f6d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/owenvoke/blade-fontawesome)[![Buy us a tree](https://camo.githubusercontent.com/910e097fe46a40add8f3484705ecbc26dc047df84b2fef027405f47408023d76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d6c69676874677265656e3f7374796c653d666c61742d737175617265)](https://ecologi.com/owenvoke?gift-trees) A package to easily make use of [Font Awesome](https://fontawesome.com) in your Laravel Blade views. For a full list of available icons see [the SVG directory](./resources/svg). Documentation for older versions -------------------------------- [](#documentation-for-older-versions) You are reading the documentation for `3.x` which uses Font Awesome 7. If you're wanting Font Awesome 6, please see the [docs for 2.x](https://github.com/owenvoke/blade-fontawesome/blob/2.x/README.md). If you're using Laravel 8 or below, please see the [docs for 1.x](https://github.com/owenvoke/blade-fontawesome/blob/1.x/README.md). Please see the [upgrade guide](UPGRADE.md) for information on how to upgrade to the latest version. Requirements ------------ [](#requirements) - PHP 8.3 or higher - Laravel 12.x or higher Install ------- [](#install) Via Composer ``` composer require owenvoke/blade-fontawesome ``` Configuration ------------- [](#configuration) Blade Font Awesome 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-fontawesome.php` config file: ``` php artisan vendor:publish --tag=blade-fontawesome-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: ``` ``` ### Icon Sets [](#icon-sets) > Note: These are default prefixes for the specified icon sets, these can all be configured [in the `config/blade-fontawesome.php` file](config/blade-fontawesome.php). **Free Icon Sets** - Brands (`fab`) - Regular (`far`) - Solid (`fas`) **Pro Icon Sets** - Duotone (`fad`) - Light (`fal`) - Thin (`fat`) - Sharp Regular (`far:sharp`) - Sharp Light (`fal:sharp`) - Sharp Solid (`fas:sharp`) - Sharp Thin (`fat:sharp`) - Sharp Duotone (`fad:sharp`) - Custom Kit Icons (`fak`) To remove any pro icon sets, set the value to `false` in the `blade-fontawesome` config file. For example: ``` 'sharp-regular' => false, ``` ### 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-fontawesome --force ``` Then use them in your views like: ``` ``` ### Font Awesome Pro [](#font-awesome-pro) Blade Font Awesome supports pro icons using npm for downloads. To use this, [install Font Awesome Pro](https://fontawesome.com/how-to-use/on-the-web/setup/using-package-managers#installing-pro) using `npm i --save @fortawesome/fontawesome-pro`, and then run the following Artisan command to add the icons to your `resources` path. ``` php artisan blade-fontawesome:sync-icons --pro ``` Blade Font Awesome will then automatically detect and use the pro icons under the `resources/icons/blade-fontawesome` path. ### Font Awesome Kits [](#font-awesome-kits) Blade Font Awesome supports the use of the npm kits via the `--kit` option. To use a configured kit, [Font Awesome docs installing kits](https://docs.fontawesome.com/web/setup/packages#kit-package) using `npm install --save '@awesome.me/kit-KIT_CODE@latest'`, and then run the following Artisan command to add the icons to your `resources` path. ``` php artisan blade-fontawesome:sync-icons --kit=KIT_CODE ``` Blade Font Awesome will then use the icons from the kit to populate the `resources/icons/blade-fontawesome` directory. ### Caching [](#caching) Because of the sheer number of icons, a small performance hit can be seen when using *pro or kit-supplied* icons. If you'd like to mitigate this, you can cache the icons. To do this, run the following Artisan command: ``` php artisan icons:cache ``` ### Blade Icons [](#blade-icons) Blade Font Awesome uses Blade Icons under the hood. Please refer to [the Blade Icons readme](https://github.com/blade-ui-kit/blade-icons) for additional functionality. Change log ---------- [](#change-log) Please see [GitHub Releases](https://github.com/owenvoke/blade-fontawesome/releases) for more information on what has changed recently. Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Owen Voke](https://github.com/owenvoke) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. Treeware -------- [](#treeware) You're free to use this package, but if it makes it to your production environment you are required to buy the world a tree. It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you support this package and contribute to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats. You can buy trees [here](https://ecologi.com/owenvoke?gift-trees). Read more about Treeware at [treeware.earth](https://treeware.earth). ### Health Score 70 — ExcellentBetter than 100% of packages Maintenance88 Actively maintained with recent releases Popularity61 Solid adoption and visibility Community37 Small or concentrated contributor base Maturity82 Battle-tested with a long release history Bus Factor1 Top contributor holds 70.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 ~63 days Recently: every ~33 days Total 34 Last Release 60d ago Major Versions 1.x-dev → v2.0.02022-02-09 2.x-dev → v3.0.02025-11-05 PHP version history (6 changes)v1.0.0PHP ^7.4 v1.3.0PHP ^7.4 || ^8.0 v2.0.0PHP ^8.0 v2.5.0PHP ^8.1 2.x-devPHP ^8.4 v3.2.1PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1899334?v=4)[Owen Voke](/maintainers/owenvoke)[@owenvoke](https://github.com/owenvoke) --- Top Contributors [![owenvoke](https://avatars.githubusercontent.com/u/1899334?v=4)](https://github.com/owenvoke "owenvoke (166 commits)")[![web-flow](https://avatars.githubusercontent.com/u/19864447?v=4)](https://github.com/web-flow "web-flow (30 commits)")[![mallardduck](https://avatars.githubusercontent.com/u/619938?v=4)](https://github.com/mallardduck "mallardduck (11 commits)")[![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (6 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (5 commits)")[![belzaaron](https://avatars.githubusercontent.com/u/21190036?v=4)](https://github.com/belzaaron "belzaaron (4 commits)")[![jackwh](https://avatars.githubusercontent.com/u/627533?v=4)](https://github.com/jackwh "jackwh (3 commits)")[![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (2 commits)")[![Ynitial](https://avatars.githubusercontent.com/u/35238373?v=4)](https://github.com/Ynitial "Ynitial (1 commits)")[![cmayorgahilario](https://avatars.githubusercontent.com/u/4119035?v=4)](https://github.com/cmayorgahilario "cmayorgahilario (1 commits)")[![pimakoto](https://avatars.githubusercontent.com/u/4119035?v=4)](https://github.com/pimakoto "pimakoto (1 commits)")[![rynomars](https://avatars.githubusercontent.com/u/96152?v=4)](https://github.com/rynomars "rynomars (1 commits)")[![TomEasterbrook](https://avatars.githubusercontent.com/u/5488110?v=4)](https://github.com/TomEasterbrook "TomEasterbrook (1 commits)")[![wit3](https://avatars.githubusercontent.com/u/5450259?v=4)](https://github.com/wit3 "wit3 (1 commits)")[![ahmed-rashad-alnaggar](https://avatars.githubusercontent.com/u/131385452?v=4)](https://github.com/ahmed-rashad-alnaggar "ahmed-rashad-alnaggar (1 commits)") --- Tags blade-iconshacktoberfest ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/owenvoke-blade-fontawesome/health.svg) ``` [![Health](https://phpackages.com/badges/owenvoke-blade-fontawesome/health.svg)](https://phpackages.com/packages/owenvoke-blade-fontawesome) ``` ### Alternatives [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)[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)[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)