PHPackages                             brunocfalcao/blade-feather-icons - 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. brunocfalcao/blade-feather-icons

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

brunocfalcao/blade-feather-icons
================================

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

v6.0(6mo ago)36745.8k↓16.8%14[5 PRs](https://github.com/brunocfalcao/blade-feather-icons/pulls)3MITPHPPHP ^8.4CI passing

Since Jun 19Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/brunocfalcao/blade-feather-icons)[ Packagist](https://packagist.org/packages/brunocfalcao/blade-feather-icons)[ Docs](https://github.com/brunocfalcao/blade-feather-icons)[ RSS](/packages/brunocfalcao-blade-feather-icons/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (24)Used By (3)

Blade Feather Icons
===================

[](#blade-feather-icons)

[ ![Latest Stable Version](https://camo.githubusercontent.com/14c128529452ca5a1f89bcf0a486b4239d4d876bf4592c9c290226ce515a1056/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f6366616c63616f2f626c6164652d666561746865722d69636f6e732f762f737461626c652e737667)](https://packagist.org/packages/brunocfalcao/blade-feather-icons)[ ![Total Downloads](https://camo.githubusercontent.com/936541305f2bd5ee6187502569cf5e2cf17eea626ee086f3cc30110c1881f286/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f6366616c63616f2f626c6164652d666561746865722d69636f6e732f642f746f74616c2e737667)](https://packagist.org/packages/brunocfalcao/blade-feather-icons)[ ![License](https://camo.githubusercontent.com/df5de3cd895f62cf52bacbb329e19e19e2dd63c04438221dd50a208bb9f569f9/68747470733a2f2f706f7365722e707567782e6f72672f6272756e6f6366616c63616f2f626c6164652d666561746865722d69636f6e732f6c6963656e73652e737667)](https://packagist.org/packages/brunocfalcao/blade-feather-icons)A Laravel package to easily use [Feather Icons](https://github.com/feathericons/feather) in your Blade views as inline SVG components.

For a full list of available icons, see [the SVG directory](resources/svg) or preview them at [feathericons.com](https://feathericons.com/).

✨ Features
----------

[](#-features)

- 🎨 **287+ Beautiful Icons** - Simple, consistent, open-source icons
- 🚀 **Zero Dependencies** - No JavaScript required, pure inline SVG
- 💎 **Laravel Integration** - Native Blade component syntax
- 🎯 **Full Control** - Add classes, styles, and attributes easily
- ⚡ **Performance** - Cached and optimized SVG rendering
- 🔧 **Customizable** - Tailwind CSS and any CSS framework compatible
- 🔄 **NPM Sync Command** - Keep icons updated from official Feather Icons releases

📋 Requirements
--------------

[](#-requirements)

- **PHP**: 8.4 or higher
- **Laravel**: 12.0 or higher
- **blade-ui-kit/blade-icons**: ^1.0

📦 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require brunocfalcao/blade-feather-icons
```

The package will automatically register itself via Laravel's package auto-discovery.

🚀 Usage
-------

[](#-usage)

### Basic Usage

[](#basic-usage)

Icons can be used as self-closing Blade components:

```

```

### Adding Classes

[](#adding-classes)

Perfect for Tailwind CSS or any CSS framework:

```

```

### Adding Inline Styles

[](#adding-inline-styles)

```

```

### Adding Multiple Attributes

[](#adding-multiple-attributes)

```

```

### Using with Alpine.js

[](#using-with-alpinejs)

```

```

### Common Examples

[](#common-examples)

```
{{-- Navigation --}}

        Dashboard

        Settings

{{-- Buttons --}}

    Download

{{-- Alerts --}}

    Warning message here

{{-- Loading States --}}

```

🎨 Available Icons
-----------------

[](#-available-icons)

All 287 Feather icons are available. Common icons include:

**Interface**: `home`, `menu`, `x`, `check`, `chevron-down`, `chevron-up`, `arrow-right`, `arrow-left`, `more-vertical`, `more-horizontal`

**Media**: `play`, `pause`, `volume`, `volume-x`, `music`, `video`, `image`, `camera`, `film`

**Communication**: `mail`, `message-circle`, `phone`, `at-sign`, `bell`, `send`

**Files**: `file`, `folder`, `download`, `upload`, `save`, `trash`, `edit`, `copy`

**Social**: `heart`, `star`, `thumbs-up`, `share`, `bookmark`

**E-commerce**: `shopping-cart`, `credit-card`, `dollar-sign`, `tag`

**Status**: `check-circle`, `x-circle`, `alert-circle`, `alert-triangle`, `info`, `help-circle`

**System**: `settings`, `user`, `lock`, `unlock`, `eye`, `eye-off`, `search`, `filter`

[View all icons →](https://feathericons.com/)

🔧 Publishing Assets (Optional)
------------------------------

[](#-publishing-assets-optional)

If you need the raw SVG files as static assets:

```
php artisan vendor:publish --tag=blade-feather-icons --force
```

This will publish the icons to `public/vendor/feather-icons/`.

Then use them in your views:

```

```

**Note:** This is rarely needed. Using Blade components (default) is recommended for better performance and control.

🔄 Syncing Icons from NPM
------------------------

[](#-syncing-icons-from-npm)

Want to keep your icons up-to-date with the latest Feather Icons releases? You can sync SVG files directly from the npm package.

### Prerequisites

[](#prerequisites)

First, install the official Feather Icons npm package in your project:

```
npm install feather-icons --save-dev
```

### Sync Command

[](#sync-command)

Run the sync command to update your package's SVG files:

```
php artisan feathericons:sync
```

This will:

- ✅ Copy all icons from `node_modules/feather-icons/dist/icons` to the package
- ✅ Detect new, updated, and unchanged icons
- ✅ Display a detailed progress report

### Dry Run

[](#dry-run)

Preview changes without actually copying files:

```
php artisan feathericons:sync --dry-run
```

Example output:

```
Syncing Feather Icons...
████████████████████████████ 100%

Total icons .......... 287
Would be added ....... 5
Would be updated ..... 12
Unchanged ............ 270

Run without --dry-run to apply these changes.

```

### Custom NPM Path

[](#custom-npm-path)

If your `node_modules` is in a non-standard location:

```
php artisan feathericons:sync --npm-path=/custom/path/to/project
```

### When to Sync

[](#when-to-sync)

- 📦 After updating the `feather-icons` npm package
- 🆕 When new icons are released by Feather Icons
- 🔧 If you manually modified icons and want to revert to originals

**Note:** This is a unique feature not available in other Blade icon packages! It gives you full control over your icon versions.

🧪 Testing
---------

[](#-testing)

The package includes comprehensive Pest tests:

```
composer test
```

Run tests with coverage:

```
composer test-coverage
```

📚 Advanced Usage
----------------

[](#-advanced-usage)

### Using the Helper Function

[](#using-the-helper-function)

You can also use the `svg()` helper function:

```
{!! svg('feathericon-heart', 'w-6 h-6 text-red-500') !!}
```

With multiple attributes:

```
{!! svg('feathericon-star', ['class' => 'w-6 h-6', 'style' => 'color: gold']) !!}
```

### Custom Prefix

[](#custom-prefix)

If you want to change the default `feathericon-` prefix, you can extend the service provider in your own application.

### Blade Icons Features

[](#blade-icons-features)

This package is built on top of [Blade Icons](https://github.com/blade-ui-kit/blade-icons). You can use all Blade Icons features:

- [Default classes](https://github.com/blade-ui-kit/blade-icons#default-classes)
- [Icon sets](https://github.com/blade-ui-kit/blade-icons#icon-sets)
- [Custom attributes](https://github.com/blade-ui-kit/blade-icons#attributes)

🐛 Troubleshooting
-----------------

[](#-troubleshooting)

### Icons not showing?

[](#icons-not-showing)

1. Make sure you've installed the package: `composer require brunocfalcao/blade-feather-icons`
2. Clear Laravel's cache: `php artisan view:clear && php artisan cache:clear`
3. Check your icon name matches the filename in `resources/svg/`

### Wrong icon name?

[](#wrong-icon-name)

Icon names use kebab-case. For example:

- `alert-triangle.svg` → ``
- `arrow-up-right.svg` → ``

### Using with Livewire?

[](#using-with-livewire)

Blade Feather Icons works perfectly with Livewire. Just use the components as normal:

```

    @if($isActive)

    @else

    @endif

```

📝 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for recent changes.

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

👨‍💻 Maintainers
---------------

[](#‍-maintainers)

**Blade Feather Icons** is developed and maintained by [Bruno Falcao](https://github.com/brunocfalcao).

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

**Feather Icons** is created by [Cole Bemis](https://github.com/colebemis).

📄 License
---------

[](#-license)

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

Feather Icons is also licensed under the [MIT license](https://github.com/feathericons/feather/blob/master/LICENSE).

🌟 Related Packages
------------------

[](#-related-packages)

- [Blade Icons](https://github.com/blade-ui-kit/blade-icons) - The foundation for this package
- [Blade Heroicons](https://github.com/blade-ui-kit/blade-heroicons) - Heroicons for Laravel
- [Blade Font Awesome](https://github.com/owenvoke/blade-fontawesome) - Font Awesome for Laravel

---

**Love this package?** Give it a ⭐️ on [GitHub](https://github.com/brunocfalcao/blade-feather-icons) and follow [@brunocfalcao](https://twitter.com/brunocfalcao) on Twitter!

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance75

Regular maintenance activity

Popularity50

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 52.1% 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 ~115 days

Recently: every ~339 days

Total

18

Last Release

192d ago

Major Versions

v1.1.3 → 2.0.02021-04-11

v2.1.0 → v3.0.02023-02-14

v3.0.0 → v4.0.02024-03-12

v4.0.0 → v5.0.02025-08-02

v5.0.0 → v6.02025-11-07

PHP version history (5 changes)v0.1.0PHP ^7.2

v1.0.0PHP ^7.3

v1.1.0PHP ^7.3|^8.0

2.0.0PHP ^7.4|^8.0

v6.0PHP ^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/26642608?v=4)[Bruno Falcão](/maintainers/brunofalcao)[@brunofalcao](https://github.com/brunofalcao)

---

Top Contributors

[![brunocfalcao](https://avatars.githubusercontent.com/u/34269950?v=4)](https://github.com/brunocfalcao "brunocfalcao (38 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (6 commits)")[![martingalian](https://avatars.githubusercontent.com/u/237761498?v=4)](https://github.com/martingalian "martingalian (6 commits)")[![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (4 commits)")[![victorybiz](https://avatars.githubusercontent.com/u/8276466?v=4)](https://github.com/victorybiz "victorybiz (1 commits)")[![amaelftah](https://avatars.githubusercontent.com/u/17250137?v=4)](https://github.com/amaelftah "amaelftah (1 commits)")[![swapnilsarwe](https://avatars.githubusercontent.com/u/166912?v=4)](https://github.com/swapnilsarwe "swapnilsarwe (1 commits)")[![troyharvey](https://avatars.githubusercontent.com/u/530530?v=4)](https://github.com/troyharvey "troyharvey (1 commits)")[![abishekrsrikaanth](https://avatars.githubusercontent.com/u/1639302?v=4)](https://github.com/abishekrsrikaanth "abishekrsrikaanth (1 commits)")

---

Tags

laravelbladeFeather Icons

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/brunocfalcao-blade-feather-icons/health.svg)

```
[![Health](https://phpackages.com/badges/brunocfalcao-blade-feather-icons/health.svg)](https://phpackages.com/packages/brunocfalcao-blade-feather-icons)
```

###  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)
