PHPackages bugo/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. bugo/blade-fontawesome ActiveLibrary[Templating & Views](/categories/templating) bugo/blade-fontawesome ====================== A package to easily make use of Font Awesome in your Laravel Blade views v3.2.1(1mo ago)0266↓35.7%1MITPHPPHP ^8.2 Since Dec 2Pushed 1mo agoCompare [ Source](https://github.com/dragomano/blade-fontawesome)[ Packagist](https://packagist.org/packages/bugo/blade-fontawesome)[ Fund](https://ecologi.com/owenvoke?gift-trees)[ GitHub Sponsors](https://github.com/owenvoke)[ RSS](/packages/bugo-blade-fontawesome/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (14)Versions (4)Used By (1) 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). Note ---- [](#note) This is a fork of the package [owenvoke/blade-fontawesome](https://github.com/owenvoke/blade-fontawesome), created specifically for those who are not yet ready to upgrade to PHP 8.4+. Requirements ------------ [](#requirements) - PHP 8.2 or higher - Laravel 12.x or higher Install ------- [](#install) Via Composer ``` composer require bugo/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 44 — FairBetter than 92% of packages Maintenance88 Actively maintained with recent releases Popularity16 Limited adoption so far Community18 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 68.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 ~54 days Total 3 Last Release 59d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6ef0dd570abdd5696bf5ba391bcd00ed0bb0ac5d1a5654785e8f204d548ddfc0?d=identicon)[Bugo](/maintainers/Bugo) --- Top Contributors [![owenvoke](https://avatars.githubusercontent.com/u/1899334?v=4)](https://github.com/owenvoke "owenvoke (164 commits)")[![web-flow](https://avatars.githubusercontent.com/u/19864447?v=4)](https://github.com/web-flow "web-flow (28 commits)")[![mallardduck](https://avatars.githubusercontent.com/u/619938?v=4)](https://github.com/mallardduck "mallardduck (11 commits)")[![dragomano](https://avatars.githubusercontent.com/u/229402?v=4)](https://github.com/dragomano "dragomano (11 commits)")[![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (6 commits)")[![belzaaron](https://avatars.githubusercontent.com/u/21190036?v=4)](https://github.com/belzaaron "belzaaron (4 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (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)")[![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)")[![cmayorgahilario](https://avatars.githubusercontent.com/u/4119035?v=4)](https://github.com/cmayorgahilario "cmayorgahilario (1 commits)")[![wit3](https://avatars.githubusercontent.com/u/5450259?v=4)](https://github.com/wit3 "wit3 (1 commits)")[![Ynitial](https://avatars.githubusercontent.com/u/35238373?v=4)](https://github.com/Ynitial "Ynitial (1 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/bugo-blade-fontawesome/health.svg) ``` [![Health](https://phpackages.com/badges/bugo-blade-fontawesome/health.svg)](https://phpackages.com/packages/bugo-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)