Weave Code
Blade Heroicons Laravel Package
blade-ui-kit/blade-heroicons
Use Heroicons in Laravel Blade via simple SVG components. Supports passing classes/styles, Blade Icons features (defaults, caching), and optional config publishing. Requires PHP 8+ and Laravel 9+.
A package to easily make use of Heroicons in your Laravel Blade views.
Frequently asked questions about Blade Heroicons
- How do I install Blade Heroicons in my Laravel project?
- Run `composer require blade-ui-kit/blade-heroicons` in your project directory. No additional steps are needed for basic usage—icons work immediately in Blade views.
- Can I use these icons in Laravel + Inertia.js projects?
- Blade Heroicons is Blade-only, so it won’t work directly in Inertia.js views. Publish the SVGs via `vendor:publish` and reference them manually in your frontend framework.
- What Laravel and PHP versions does Blade Heroicons support?
- This package requires **PHP 8.0+** and **Laravel 9+**. It drops support for older versions intentionally, aligning with modern Laravel stacks.
- How do I customize default icon classes or attributes globally?
- Publish the config file with `php artisan vendor:publish --tag=blade-heroicons-config`, then modify `config/blade-heroicons.php` to set defaults for all icons.
- Does Blade Heroicons support dark mode automatically?
- No, dark mode requires manual class toggling (e.g., `text-gray-500` for light, `text-gray-400` for dark). The package provides no built-in theming logic.
- Are there performance benefits to using SVG icons with Blade Heroicons?
- Yes. Blade Heroicons leverages **Blade Icons’ caching** to compile SVGs once and reuse them, reducing runtime overhead. Icons are also optimized for size.
- How do I find all available Heroicons in this package?
- Browse the bundled SVGs in `resources/svg` or preview them at [heroicons.com](https://heroicons.com/). The package includes all 4 styles: outline, solid, mini, and micro.
- What if I need to dynamically generate icons based on conditions?
- Use Blade’s `@if` directives or pass dynamic classes/attributes to the component. Advanced use cases may require custom Blade Icons logic.
- Is Blade Heroicons actively maintained? How often are updates released?
- Yes, it’s actively maintained by **Dries Vints**, a core Laravel contributor. Updates align with Heroicons releases and Laravel’s long-term support cycles.
- What alternatives exist for adding Heroicons to Laravel?
- Alternatives include **Laravel Heroicons** (CDN-based) or manually embedding SVGs. Blade Heroicons stands out by offering **Blade components, caching, and zero JS dependencies**.
Weaver
How can I help you explore Laravel packages today?