๐ฎ Filament Game Icons

**The ultimate Game Icons collection for FilamentPHP**
[](https://packagist.org/packages/alizharb/filament-game-icons)
[](https://packagist.org/packages/alizharb/filament-game-icons)
[](LICENSE)
[](https://packagist.org/packages/alizharb/filament-game-icons)
[](https://scrutinizer-ci.com/g/alizharb/filament-game-icons)
[](https://filamentphp.com)
_Transform your FilamentPHP applications with 4000+ beautiful game icons_
[๐ Documentation](#-documentation) โข [๐ Quick Start](#-quick-start) โข [๐ก Examples](#-examples) โข [๐ค Contributing](#-contributing)
โจ Features
### ๐ฏ **Core Features**
- ๐ฎ **4000+ Game Icons** - Complete collection from game-icons.net
- ๐ง **Type Safe** - Full PHP enum with IDE autocompletion
- ๐ท๏ธ **Human Readable** - Implements `HasLabel` for better UX
- ๐ฆ **Zero Config** - Works out of the box
- โก **Optimized** - Blazing fast with smart caching
|
### ๐ ๏ธ **Developer Experience**
- ๐ **Searchable** - Built-in search and categorization
- ๐จ **Customizable** - Easy theming and icon replacement
- ๐ฑ **Responsive** - Looks great on all devices
- ๐ **Auto-sync** - Keep icons updated automatically
- ๐ก **IntelliSense** - Full IDE support
|
๐ Quick Start
Installation
Install the package via Composer:
Asset Registration
Register the assets with FilamentPHP:
Basic Usage
Start using Game Icons immediately in any FilamentPHP component:
๐ Documentation
๐๏ธ Architecture Overview
๐ฏ Component Integration
๐ Actions & Buttons
๐ Form Components
๐ Table Columns
๐ฑ Widgets & Dashboard
๐๏ธ Icon Categories
| Category | Count | Examples | Usage |
| -------------------- | ----- | -------------------------------------- | ---------------------------- |
| **โ๏ธ Weapons** | 500+ | `Sword`, `BowArrow`, `Shield`, `Axe` | Combat systems, inventory |
| **๐ฎ Magic** | 300+ | `MagicSwirl`, `HealingPotion`, `Rune` | Spell systems, enchantments |
| **๐ค Characters** | 200+ | `Wizard`, `Warrior`, `Archer`, `Rogue` | Character selection, classes |
| **๐ Creatures** | 400+ | `Dragon`, `Wolf`, `Phoenix`, `Demon` | Bestiary, enemy systems |
| **๐ Items** | 600+ | `Armor`, `Crown`, `Gem`, `Treasure` | Inventory, rewards |
| **๐ฒ Dice & Gaming** | 50+ | `D4`, `D6`, `D20`, `Cards` | Game mechanics, RNG |
| **๐ฐ Environment** | 300+ | `Castle`, `Forest`, `Cave`, `Tower` | World building, locations |
| **โ๏ธ Interface** | 200+ | `Settings`, `Menu`, `Save`, `Load` | UI elements, navigation |
๐ก Examples
๐ฎ Complete Gaming Resource
Character Management System
๐ Advanced Dashboard Widgets
๐ง API Reference
๐ท๏ธ GameIcons Enum Methods
๐ Search & Filtering
โ๏ธ Configuration
๐จ Custom Styling
Publish and customize the CSS:
๐ง Icon Replacement
Replace default FilamentPHP icons system-wide:
๐ฎ Gaming-Specific Helpers
๐ ๏ธ Management Commands
๐ฅ Sync Command
Keep your icons up-to-date with the latest from game-icons.net:
๐จ Theming Examples
๐ Dark Mode Support
๐ญ Custom Icon Themes
๐งช Testing
Running Tests
๐ฏ Test Examples
๐ Performance
โก Optimization Features
- Smart Caching: Icons are cached for maximum performance
- Lazy Loading: Only loads icons when needed
- SVG Optimization: Minified SVG files for faster loading
- Bundle Splitting: Load only the categories you need
๐ Security
๐ก๏ธ Security Features
- โ
XSS Protection: All icon names are sanitized
- โ
Path Traversal Prevention: Secure file handling
- โ
Input Validation: Strict type checking
- โ
No Executable Code: Pure SVG icons only
๐ Security Testing
๐ Plugin Integration
๐ฏ Popular FilamentPHP Plugin Compatibility
| Plugin | Status | Integration Example |
| -------------------------- | --------------- | ----------------------------------------------------- |
| **Filament Tables** | โ
Full Support | `IconColumn::make()->icon(GameIcons::Sword)` |
| **Filament Forms** | โ
Full Support | `Select::make()->options(GameIcons::toSelectArray())` |
| **Filament Actions** | โ
Full Support | `Action::make()->icon(GameIcons::Attack)` |
| **Filament Widgets** | โ
Full Support | `Stat::make()->descriptionIcon(GameIcons::Trophy)` |
| **Filament Notifications** | โ
Full Support | `Notification::make()->icon(GameIcons::Success)` |
๐ Third-party Integrations
๐ Migration Guide
โฌ๏ธ From Heroicons to Game Icons
๐ค Contributing
We love contributions! Here's how you can help make this package even better:
๐ฏ Ways to Contribute
- ๐ Bug Reports: Found an issue? Report it here
- ๐ก Feature Requests: Got an idea? Share it with us
- ๐ Documentation: Help improve our docs
- ๐งช Testing: Add more test cases
- ๐จ Icon Categories: Suggest new categorizations
๐ ๏ธ Development Setup
๐ Contribution Guidelines
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
)
- Commit your changes (
git commit -m 'Add amazing feature'
)
- Push to the branch (
git push origin feature/amazing-feature
)
- Open a Pull Request
๐ Requirements
| Requirement | Version | Status |
| -------------------- | ------------------ | ----------------- |
| **PHP** | 8.1+ | โ
|
| **Laravel** | 10.x / 11.x / 12.x | โ
|
| **FilamentPHP** | 4.x | โ
|
| **Blade Game Icons** | ^1.0 | โ
Auto-installed |
๐ง Troubleshooting
โ Common Issues
Icons not displaying
**Solution:**
IDE autocompletion not working
**Solution:**
Performance issues with large icon sets
**Solution:**
๐ Statistics
### ๐ **Package Stats**



### ๐ฎ **Icon Collection**
| **Total Icons** | **Categories** | **Weekly Downloads** | **GitHub Stars** |
| :-------------: | :------------: | :------------------: | :--------------: |
| 4,000+ | 8 Major | 1,000+ | 50+ |
๐๏ธ Showcase
๐ Projects Using Filament Game Icons
Want your project featured here? Submit it!
๐ Resources
๐ Documentation & Guides
๐ฏ FilamentPHP Resources
๐ฎ Game Development
๐ License & Attribution
๐ Package License
This package is open-sourced software licensed under the MIT License.
๐จ Game Icons License
The Game Icons used in this package are licensed under CC BY 3.0.
Required Attribution:
๐ Acknowledgments
### ๐ **Special Thanks**
| Contributor | Role | Contribution |
| ----------------------------------------------------------------------------------- | ------------------- | ---------------------------------- |
| ๐จ [**Game Icons**](https://game-icons.net/) | Icon Creators | Amazing 4000+ icon collection |
| ๐ง [**Blade Game Icons**](https://github.com/codeat3/blade-game-icons) | Laravel Integration | Seamless Laravel blade integration |
| ๐ [**FilamentPHP Team**](https://filamentphp.com/) | Framework | Outstanding admin panel framework |
| ๐ฅ [**Contributors**](https://github.com/alizharb/filament-game-icons/contributors) | Community | Continuous improvements |
๐ Support
๐ฌ Get Help
| Support Channel | Response Time | Best For |
| ---------------------------------------------------------------------------------------- | ------------- | ----------------------------- |
| ๐ [**GitHub Issues**](https://github.com/alizharb/filament-game-icons/issues) | 24-48 hours | Bug reports, feature requests |
| ๐ฌ [**GitHub Discussions**](https://github.com/alizharb/filament-game-icons/discussions) | 12-24 hours | Questions, ideas, showcase |
| ๐ [**FilamentPHP Discord**](https://discord.gg/filamentphp) | Real-time | Community support |
| ๐ง [**Email Support**](mailto:
[email protected]) | 48-72 hours | Private/commercial inquiries |
๐ Before Reporting Issues
- โ
Check existing issues
- โ
Read the documentation
- โ
Try the troubleshooting guide
- โ
Provide clear reproduction steps
๐ก Pro Tips
๐ฏ Best Practices
โก Performance Tips
๐ Related Packages
๐ฎ Ecosystem
## ๐ Star History
[](https://star-history.com/#alizharb/filament-game-icons&Timeline)
---
## ๐ Show Your Support
**If this package helped you build something awesome, consider:**
[](https://github.com/sponsors/alizharb)
โญ **Star this repository**
๐ฆ **Share on Twitter**
๐ **Write a blog post**
๐ฃ๏ธ **Tell your friends**
---
**Made with โค๏ธ and โ for the FilamentPHP community**
[โญ Star](https://github.com/alizharb/filament-game-icons) โข
[๐ด Fork](https://github.com/alizharb/filament-game-icons/fork) โข
[๐ Issues](https://github.com/alizharb/filament-game-icons/issues) โข
[๐ฌ Discussions](https://github.com/alizharb/filament-game-icons/discussions) โข
[๐ Wiki](https://github.com/alizharb/filament-game-icons/wiki)
---
_Built by [Ali Harb](https://github.com/alizharb) โข Powered by [FilamentPHP](https://filamentphp.com) โข Icons from [Game Icons](https://game-icons.net/)_