Weave Code
Flowbite Blade Icons Laravel Package
themesberg/flowbite-blade-icons
Use Flowbite Icons in Laravel Blade via Blade UI Kit. Provides outline and solid SVG icons as Blade components and @svg directive, with support for classes, attributes, and caching. PHP 8.1+ and Laravel 9+.
Official collection of Flowbite SVG icons in Blade
Frequently asked questions about Flowbite Blade Icons
- How do I install Flowbite Blade Icons in a Laravel 9+ project?
- Run `composer require themesberg/flowbite-blade-icons` in your project root. No additional configuration is needed for basic usage, though you can publish the config file later with `php artisan vendor:publish --tag=flowbite-blade-icons-config`.
- Does this package work with Laravel 8 or PHP 8.0?
- No, this package requires **PHP 8.1+** and **Laravel 9+**. If you’re on an older version, consider alternatives like Blade Icons or Laravel Heroicons, which support broader Laravel versions.
- Can I use Flowbite Icons outside Blade templates (e.g., in JavaScript or emails)?
- Yes, you can publish raw SVG assets with `php artisan vendor:publish --tag=flowbite-blade-icons-assets`, then reference them directly in non-Blade contexts like JS or email templates.
- How do I customize icon classes or attributes globally?
- Publish the config file (`php artisan vendor:publish --tag=flowbite-blade-icons-config`) and set defaults in `config/flowbite-blade-icons.php` under `default_classes` or `default_attributes`.
- What’s the performance impact of using Blade components for icons?
- Blade components add minimal overhead, but caching (enabled via Blade Icons) significantly improves performance. For high-traffic apps (>10K requests/day), test caching with `blade-icons.cache` set to `true` in the config.
- Are there limits to the number of icons I can use?
- The package includes **~1,000 icons** from Flowbite’s library. For custom icons, you’d need to manually add them or fork the package, as there’s no built-in API for extending the icon set.
- How does this compare to Laravel Heroicons or Blade Icons?
- This package is **Flowbite-specific**, offering tighter integration with Flowbite UI components. Heroicons or Blade Icons provide broader icon sets but lack Flowbite’s visual consistency. Choose based on your design system needs.
- Can I use solid and outline icons interchangeably?
- Yes, use `<x-fwb-s-icon-name/>` for solid icons and `<x-fwb-o-icon-name/>` for outlines. Both support classes, attributes, and the `@svg` directive identically.
- What if I need to support multi-tenancy with custom icons?
- The package doesn’t natively support dynamic icon sets per tenant. Workarounds include using the `@svg` directive with dynamic paths or extending the package to load tenant-specific SVGs.
- Is there a way to preview all available icons before using them?
- Yes, browse the full icon library at [flowbite.com/icons](https://flowbite.com/icons/) or check the `resources/svg` directory in the package’s GitHub repo for a local reference.
Weaver
How can I help you explore Laravel packages today?