PHPackages aerni/font-awesome - 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. aerni/font-awesome ActiveLibrary[Utility & Helpers](/categories/utility) aerni/font-awesome ================== A Statamic addon to easily add Font Awesome icons. v4.0.1(2mo ago)535.8k↑50.9%8MITPHPPHP ^8.3CI passing Since Nov 18Pushed 2mo ago2 watchersCompare [ Source](https://github.com/aerni/statamic-font-awesome)[ Packagist](https://packagist.org/packages/aerni/font-awesome)[ Docs](https://github.com/aerni/statamic-font-awesome)[ GitHub Sponsors](https://github.com/aerni)[ RSS](/packages/aerni-font-awesome/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (4)Versions (18)Used By (0) [![Statamic](https://camo.githubusercontent.com/52f227167b36d6b4e51b2716643af8c149223e9fe8bdf50bbf442653d0d1f87f/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f362e302b2f464632363945)](https://camo.githubusercontent.com/52f227167b36d6b4e51b2716643af8c149223e9fe8bdf50bbf442653d0d1f87f/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f362e302b2f464632363945) [![Packagist version](https://camo.githubusercontent.com/6dbfd5810bfb4d87a7665ee76c8bd19e1c6bc5f40a80380807d601fc4a67eb06/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f666f6e742d617765736f6d652f6c6174657374)](https://camo.githubusercontent.com/6dbfd5810bfb4d87a7665ee76c8bd19e1c6bc5f40a80380807d601fc4a67eb06/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f666f6e742d617765736f6d652f6c6174657374) [![Packagist Total Downloads](https://camo.githubusercontent.com/2941952aaa7a9176b1806f8e1c46f828d2850f874389c1bcd451a707b512254d/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f666f6e742d617765736f6d65)](https://camo.githubusercontent.com/2941952aaa7a9176b1806f8e1c46f828d2850f874389c1bcd451a707b512254d/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f666f6e742d617765736f6d65) Font Awesome ============ [](#font-awesome) This Statamic addon features an icon fieldtype to browse and select Font Awesome 6.x icons. It also comes with a Tag to output selected icons in your template. Installation ------------ [](#installation) Install the addon using Composer: ``` composer require aerni/font-awesome ``` After installation, publish the assets: ``` php artisan vendor:publish --tag=font-awesome --force ``` You may publish the config of the package: ``` php please vendor:publish --tag=font-awesome-config ``` Configuration ------------- [](#configuration) You may choose between using a Kit or hosting Font Awesome yourself. ### Kit Driver [](#kit-driver) If you want to use a Kit, make sure you set the `driver` option in the config to `kit`: ``` 'driver' => 'kit' ``` Next, add your `API Token` and `Kit Token` to your `.env` file: ``` FA_API_TOKEN=************************************ FA_KIT_TOKEN=************************************ ``` ### Local Driver [](#local-driver) If you would rather host Font Awesome yourself, you may use the `local` driver: ``` 'driver' => 'local' ``` Next, download [Font Awesome (For The Web)](https://fontawesome.com/download) and place the `metadata` and `css` directories in the locations defined in the config: ``` 'local' => [ 'metadata' => resource_path('fonts/fontawesome/metadata'), 'css' => '/fonts/fontawesome/css/all.min.css', ], ``` #### Metadata [](#metadata) The files in the `metadata` directory are required to get the information about the icons. I recommend placing the metadata in the `resources` directory, as these files don't need to be publicly accessible. #### CSS [](#css) The `css` config option defines the public path to the stylesheet that will be loaded in the Control Panel. The stylesheet must be placed in the `public` directory. The CSS will only be loaded in the Control Panel. You still need to add the stylesheet to your frontend layout yourself. Usage ----- [](#usage) ### Fieldtype [](#fieldtype) Add the `Font Awesome` Fieldtype to a Blueprint or Fieldset. The Fieldtype provides a config option that allows you to make only certain icon styles available for selection. ### Tag [](#tag) If you're using the `kit` driver, add the following Tag to your layout's `` to render the Font Awesome script. ``` {{ font_awesome:kit }} ``` Render an icon by using the handle of a Font Awesome field as the wildcard method. ``` {{ font_awesome:icon_field }} ``` You may also use the shorter tag alias instead. ``` {{ fa:kit }} {{ fa:icon_field }} ``` Credits ------- [](#credits) Developed by [Michael Aerni](https://www.michaelaerni.ch) ### Health Score 56 — FairBetter than 97% of packages Maintenance83 Actively maintained with recent releases Popularity37 Limited adoption so far Community16 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor1 Top contributor holds 84% 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 ~100 days Recently: every ~121 days Total 17 Last Release 86d ago Major Versions v1.3.2 → v2.0.02023-05-12 v2.1.1 → v3.0.02024-07-01 v2.0.1 → v4.0.02026-03-11 PHP version history (3 changes)v1.0.0PHP ^8.0 v2.1.0PHP ^8.1 v4.0.0PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/23167701?v=4)[Michael Aerni](/maintainers/aerni)[@aerni](https://github.com/aerni) --- Top Contributors [![aerni](https://avatars.githubusercontent.com/u/23167701?v=4)](https://github.com/aerni "aerni (21 commits)")[![waldemar-p](https://avatars.githubusercontent.com/u/21173835?v=4)](https://github.com/waldemar-p "waldemar-p (2 commits)")[![mnlmaier](https://avatars.githubusercontent.com/u/15020024?v=4)](https://github.com/mnlmaier "mnlmaier (1 commits)")[![Oleafeon](https://avatars.githubusercontent.com/u/20043831?v=4)](https://github.com/Oleafeon "Oleafeon (1 commits)") --- Tags statamicstatamic-addonfont-awesomestatamic ### Embed Badge ![Health badge](/badges/aerni-font-awesome/health.svg) ``` [![Health](https://phpackages.com/badges/aerni-font-awesome/health.svg)](https://phpackages.com/packages/aerni-font-awesome) ``` ### Alternatives [statamic-rad-pack/runway Eloquently manage your database models in Statamic. 135224.7k7](/packages/statamic-rad-pack-runway)[statamic/statamic Statamic 829179.5k](/packages/statamic-statamic)[duncanmcclean/statamic-cargo Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity. 3416.9k](/packages/duncanmcclean-statamic-cargo)[marcorieser/statamic-livewire A Laravel Livewire integration for Statamic. 23111.5k15](/packages/marcorieser-statamic-livewire)[aerni/livewire-forms A Statamic forms framework powered by Laravel Livewire 2915.1k](/packages/aerni-livewire-forms)[aerni/advanced-seo Comprehensive SEO addon for Statamic with flexibility in mind 1818.2k](/packages/aerni-advanced-seo) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)