- What is wallacemartinss/filament-icon-picker used for?
- It provides an icon picker component for Filament v5 forms, tables, and infolists. It renders a modal grid of icons from blade-ui-kit/blade-icons packages with real-time search, set filtering, and infinite scroll. The consuming application stores only the selected icon identifier string, such as heroicon-o-star, in its own schema.
- How do I install filament-icon-picker in Laravel?
- Run composer require wallacemartinss/filament-icon-picker, then run php artisan filament-icon-picker:install-icons to choose at least one icon package interactively. Add the documented Tailwind @source line to your theme CSS, rebuild assets, and optionally publish the config. The package requires PHP 8.2+, Laravel 12+, and Filament 5.0+.
- Does filament-icon-picker support Laravel 11 or Filament 3?
- No, the package requires Laravel 12+ and Filament 5.0+ as documented. Filament 3 and Laravel 10–11 projects cannot adopt it without first upgrading the panel to Filament 5. There is no incremental compatibility path from Filament 3; adoption is binary.
- Which icon sets can I use with filament-icon-picker?
- Any icon set installable through blade-ui-kit/blade-icons works, including Heroicons, Font Awesome, Phosphor, Material, Tabler, and Lucide. The interactive installer lists available packs and approximate icon counts. Install only the sets you need because some packs add thousands of icons and license terms vary, especially Font Awesome brands.
- How do I configure the Filament icon picker modal size and columns?
- Publish the package config and adjust options such as modal size, grid columns, and available icon sets. The picker also supports set filtering and real-time search inside the modal. Keep the config in version control so every environment renders the same icon catalog.
- Can I show icons in a Filament table column or infolist?
- Yes, the package provides IconPickerColumn for tables and IconPickerEntry for read-only infolist displays, alongside IconPickerField for forms. Each extension point is optional and can be adopted independently. They display the stored icon identifier using blade-icons.
- Why are my Filament icon picker styles missing after deployment?
- The documented Tailwind @source path points to a vendor directory relative to your theme CSS file. Moving the theme file or changing the build structure can silently drop picker styles, and tests may not catch the failure. Verify the @source line in CI and rebuild Tailwind assets during deployment.
- Does filament-icon-picker have a test suite and production usage?
- The repository's maturity signals are mainly readme, docs, and changelog, with no visible test suite in the provided assessment. It has a single maintainer, around 50 stars, and no evidence of production dependents. Treat it as an early-stage dependency and plan for code review or a fallback.
- What are alternatives to filament-icon-picker for Filament?
- You can use a plain Filament Select field populated with icon names, or build a custom modal picker around blade-icons. Some projects use a searchable select plus icon preview instead of a full grid. Choose alternatives if you need Filament 3 support, a maintained test suite, or stricter accessibility guarantees.
- Is filament-icon-picker safe for production and what is the maintenance risk?
- It is MIT licensed and architecturally low-risk because it stores only an icon string and can be swapped out. However, it pins to Filament 5 and Laravel 12, has a bus factor of one, and inherits upstream Filament churn. Review generated enums, icon pack licenses, accessibility, and CSP behavior before adopting, and be prepared to fork or replace it.