- How do I install and use the free Hugeicons set in Laravel Flux?
- Run `composer require abduns/hugeicons-flux` and use Blade components like `<flux:icon.hugeicons.home-01 />`. The package bundles 5,100+ free Stroke Rounded icons out of the box. No additional setup is required for the free set.
- What Laravel and PHP versions does this package support?
- This package requires **PHP 8.3+** and is tested with **Laravel 13**. While Laravel 12 may work, it’s untested in CI. PHP 8.2 users will need to upgrade to access Pro icon features.
- Can I generate Pro icons from my Hugeicons license?
- Yes, use the `hugeicons:build` Artisan command to generate all 9 Pro styles. Ensure your `.npmrc` is configured with your Hugeicons license key, and PHP 8.3+ is installed for license validation.
- How do I use Pro icons in Flux components like buttons or nav items?
- After generating Pro icons, use them like free icons: `<flux:button icon="hugeicons.calendar-03" />` or `<flux:navlist.item icon="hugeicons.dashboard-square-01">Dashboard</flux:navlist.item>`. The `variant` prop can also be used for Pro-specific styles.
- Does this package work with Laravel Boost, Codex, or Claude Code?
- Yes, it includes a **Boost Agent Skill** for AI workflows. Run `php artisan hugeicons:boost-skill` to publish it to your `.ai/skills` directory. Boost will auto-discover it during `boost:install` or `boost:update --discover`.
- What if I only need free icons and not Pro styles?
- You don’t need to generate Pro icons. The free Stroke Rounded set is bundled and ready to use immediately. Just install the package and start using `<flux:icon.hugeicons.*>` components in your Blade views.
- Are there performance concerns with Pro icon generation?
- No, Pro icon generation has negligible overhead (<1ms render time). The build process runs locally during development, and only the final icons are included in your assets. Free icons add zero runtime cost.
- How do I customize or override icons?
- You can override icons by publishing the package’s assets and modifying the generated files. Use the `hugeicons:build` command with custom configurations, or manually edit the compiled icon files in `resources/views/vendor/hugeicons-flux`.
- What if I encounter issues with Laravel 13 or Flux 2?
- While Laravel 13 is now in the CI matrix, test Pro icons in a staging environment if you’re using Laravel 13. Flux 2 compatibility remains unchanged, but monitor the Laravel 13 changelog for Flux-related updates. Report issues to the GitHub repo.
- Are there alternatives to this package for Flux icons?
- If you’re not using Hugeicons, Flux UI supports standard SVG icons via the `icon` prop (e.g., `<flux:button icon="path-to-icon.svg" />`). For Hugeicons specifically, this is the only Laravel Flux-native package offering Pro-style generation and Boost integration.