Weave Code
Filament Icons Laravel Package
tomatophp/filament-icons
Filament Icons adds an icon picker, icon table column, and icon provider to FilamentPHP. Install via Composer, cache icons with filament-icons:install, then use IconPicker and IconColumn in forms and tables, including custom icons.
Filament Icons is a picker, table column, and icon provider for FilamentPHP. It adds a searchable IconPicker form component and an IconColumn for rendering icons in tables, plus an artisan command to cache every available icon for fast lookups.
Install with composer require tomatophp/filament-icons, then run php artisan filament-icons:install. Both components are drop-in and support the usual label and default chainable methods, and the provider can be extended with custom icons.
- Searchable icon picker form field
- Icon table column
- One-command icon caching
- Custom icon set support
- Dark and light mode ready
Frequently asked questions about Filament Icons
- How do I install tomatophp/filament-icons and cache the icons?
- Install the package with composer require tomatophp/filament-icons. Then run php artisan filament-icons:install to cache all available icons. You can optionally publish the package configuration if you need to customize icon providers or sets.
- What Laravel, PHP, Filament, and Livewire versions does filament-icons require?
- The v5 line requires Laravel 12 or 13, PHP 8.3 or 8.4, Filament ^5.0, and Livewire 4. The package tracks Filament majors across branches, so the v4 branch is the line to use for Filament 4 projects. Older Laravel 10 or 11 and Filament v3 setups are outside the current supported path.
- How do I add an icon picker to a Filament form?
- Use IconPicker::make('icon') inside your Filament form schema. You can chain options such as default('heroicon-o-academic-cap') and label('Icon') to set the initial value and field label. It is designed to slot into existing Filament resources and pages.
- How do I render an icon in a Filament table column?
- Add IconColumn::make('icon') to your Filament table columns array. You can label the column like any other Filament table column. The package provides the icon column component so stored icon names render consistently in the admin table.
- How can I add custom icons or my own icon set to filament-icons?
- Filament Icons is built around a customizable icon provider, so you can register your own icon sets or custom SVG icons. After adding icons, rerun the cache command so the picker can discover them. Treat uploaded SVGs as untrusted input and sanitize them before display.
- Does filament-icons support dark mode in Filament panels?
- Yes, the package is intended to support Filament dark and light mode, and its screenshots show picker and column states in both themes. Re-verify theme behavior after moving to Livewire 4 and Filament 5, because rendering changes can affect UI details. Test the picker and column in your actual panel theme before rollout.
- Is it safe to use SVG icon uploads with filament-icons?
- SVG uploads are an XSS risk if used without sanitization, and the package does not remove that responsibility from your app. Enforce sanitization with a library such as spatie/svg-sanitizer or an equivalent solution before storing or rendering uploaded SVGs. Restrict who can upload icons and validate file contents in production.
- Can I use filament-icons outside Filament or without Livewire?
- No, the package has no standalone value outside Filament and is unusable without it. Filament brings Livewire as part of its stack, so the package is tied to that ecosystem. Adopt it only where Filament is already your admin surface.
- How does filament-icons handle Filament v5 versus the v4 branch?
- The v5.0.0 release targets Filament ^5.0 and therefore Livewire 4, while the v4 line continues on the v4 branch for Filament 4 projects. Because the package now tracks Filament majors across separate branches, treat a Filament upgrade and a filament-icons upgrade as a coupled change. Confirm your current Filament line and the v4 branch support window before pinning versions.
- How can I reduce icon bloat and handle missing icons in production?
- Avoid shipping full Tabler icon bundles; use subset icon sets and lazy-loading where possible. Missing-icon fallback behavior and CDN fallback are open questions, so test how your panel renders when an icon name is absent. Review bundle size and fallback behavior before deploying to production.
Weaver
How can I help you explore Laravel packages today?