afatmustafa/blade-hugeicons

A package to easily make use of Hugeicons(Free version) in your Laravel Blade views.

v2.0.2 2026-07-20 03:07 UTC

Requires

• php: ^8.1
• blade-ui-kit/blade-icons: ^1.1|^1.8
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• laravel/pint: ^1.21
• orchestra/testbench: ^8.0|^9.0|^10.0|^11.0
• phpunit/phpunit: ^10.1|^11.5|^12.0

MIT

• Mustafa Afat

• laravel
• blade
• Hugeicons

Published on Packagist.org on 2026-07-20 03:09 UTC

README

A package to easily make use of Hugeicons (Free version) in your Laravel Blade views.

The package currently includes 6,200 SVG icons sourced from @hugeicons/core-free-icons v4.2.2. For the full list, see the SVG directory or preview the icons at hugeicons.com.

Note This package only includes the free Hugeicons set. For additional icons, see Hugeicons Pro.

Requirements

• PHP 8.1 or higher
• Laravel 10, 11, 12, or 13

Installation

composer require afatmustafa/blade-hugeicons

Blade Icons

Blade Hugeicons uses Blade Icons under the hood. Please refer to the Blade Icons readme for additional functionality. We also recommend to enable icon caching with this library.

Configuration

Blade Hugeicons 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-hugeicons.php config file:

php artisan vendor:publish --tag=blade-hugeicons-config

Usage

Icons can be used as self-closing Blade components which will be compiled to SVG icons:

<x-hugeicons-youtube/>

You can also pass classes to your icon components:

<x-hugeicons-youtube class="w-6 h-6 text-gray-500"/>

And even use inline styles:

<x-hugeicons-youtube style="color: #555"/>

You can also customize the icon's stroke-width in several ways

<x-hugeicons-youtube stroke-width="1.5"/>
<x-hugeicons-youtube class="stroke-2"/>
<x-hugeicons-youtube style="stroke-width: 2px"/>

Also, any standard SVG attributes can be used as well, making it easy to control size, color, stroke style, and more

<x-hugeicons-youtube stroke-width="1.5" width="24" height="24" color="red" stroke-linecap="round"/>

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-hugeicons --force

Then use them in your views like:

<img src="{{ asset('vendor/blade-hugeicons/youtube.svg') }}" width="10" height="10"/>

Changelog

Check out the CHANGELOG in this repository for all the recent changes.

Maintainers

Blade Hugeicons is developed and maintained by Mustafa Afat.

License

Blade Hugeicons is open-sourced software licensed under the MIT license.