Introduction

Blade Ionicons brings the complete Ionicons library to your Laravel Blade views as self-closing components. Write a single tag like <x-ionicon-heart /> and the package compiles it to an inline SVG — no asset pipeline, no image requests, no extra markup.

It is a thin, well-behaved layer on top of blade-ui-kit/blade-icons: Blade Ionicons simply registers Ionicons as an icon set named ionicons with the component prefix ionicon, and lets you lean on every feature Blade Icons already provides.

What are Ionicons?

Ionicons is a beautifully crafted, open-source icon library originally built for the Ionic Framework. Each icon ships in three styles, plus a large set of brand logos:

Filled — the default, solid style (e.g. heart).
Outline — a lighter, stroked style (e.g. heart-outline).
Sharp — squared corners for a more geometric look (e.g. heart-sharp).
Logos — brand marks prefixed with logo- (e.g. logo-github, logo-apple).

There are over 1,300 SVGs in total. You can browse and search every one at ionicons.com.

What this package does

Blade Ionicons turns each of those SVGs into a Blade component you can use anywhere in a view:

<x-ionicon-logo-apple class="w-6 h-6 text-gray-500" />

Because the icon is rendered inline as SVG, it inherits text color through currentColor, scales crisply at any size, and can be styled with the same classes and inline styles you use on any other element. There is nothing to bundle and nothing to download at runtime.

It is just Blade Icons underneath

Anything you can do with Blade Icons — the @svg directive, the svg() helper, default classes, default attributes, and a fallback icon — works here too. The Usage page covers each of these.

Why use it

Ergonomic. One tag per icon. No manual SVG copy-pasting, no sprite sheets to maintain.
Stylable. Pass class="…" and style="…"; size and color icons like any other element.
Complete. Every Ionicons style — filled, outline, sharp — and every brand logo is included.
Zero runtime cost. Icons render server-side as inline SVG. No build step, no extra HTTP requests.
Familiar. Built on the widely used Blade Icons toolkit, so it composes cleanly with the rest of that ecosystem.

Requirements

PHP 8.1 or higher
Laravel 10.0 or higher (supports Laravel 10, 11, and 12)

The package depends on blade-ui-kit/blade-icons and illuminate/support, both pulled in automatically by Composer.

Credits

Ionicons are designed and maintained by the Ionic Framework Team. Blade Ionicons only packages those SVGs for convenient use in Laravel Blade and is not affiliated with Ionic. The underlying Blade rendering is powered by Blade Icons.

Next steps

Head to Installation to add the package to your project, then read Usage to start dropping icons into your views.