# Filament Icons

> Source: https://tomatophp.com/docs/filament/filament-icons

![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/fadymondy-tomato-icons.jpg)

# Filament Icons Picker & Provider

[![Latest Stable Version](https://poser.pugx.org/tomatophp/filament-icons/version.svg)](https://packagist.org/packages/tomatophp/filament-icons)
[![License](https://poser.pugx.org/tomatophp/filament-icons/license.svg)](https://packagist.org/packages/tomatophp/filament-icons)
[![Downloads](https://poser.pugx.org/tomatophp/filament-icons/d/total.svg)](https://packagist.org/packages/tomatophp/filament-icons)
[![Dependabot Updates](https://github.com/tomatophp/filament-icons/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/tomatophp/filament-icons/actions/workflows/dependabot/dependabot-updates)
[![PHP Code Styling](https://github.com/tomatophp/filament-icons/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/tomatophp/filament-icons/actions/workflows/fix-php-code-styling.yml)
[![Tests](https://github.com/tomatophp/filament-icons/actions/workflows/tests.yml/badge.svg)](https://github.com/tomatophp/filament-icons/actions/workflows/tests.yml)

Picker & Table Column & Icons Provider for FilamentPHP

## Screenshots

![Dark Input](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/input-dark.png)

![Dark Input Select](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/input-select-dark.png)

![Light Input](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/input-light.png)

![Light Input Select](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/input-select-light.png)

![Table Column](https://raw.githubusercontent.com/tomatophp/filament-icons/master/arts/column.png)

## Installation

```bash
composer require tomatophp/filament-icons
```

after install use this command to cache all icons

```bash
php artisan filament-icons:install
```

## Usage

```php
use TomatoPHP\FilamentIcons\Components\IconPicker;

public static function form(Form $form): Form
{
    return $form
        ->schema([
            IconPicker::make('icon')
                ->default('heroicon-o-academic-cap')
                ->label('Icon'),
        ]);
}
```

```php
use TomatoPHP\FilamentIcons\Components\IconColumn;

public static function table(Table $table): Table
{
    return $table
        ->columns([
            IconColumn::make('icon')
                ->label('Icon'),
        ]);
}
```

## Add Custom Icons

you can add a custom icon lib by use this Facade class inside your provider like this

```php
use TomatoPHP\FilamentIcons\Facades\FilamentIcons;

public function boot(): void
{
    FilamentIcons::register('boxicons')
        ->asset('https://unpkg.com/boxicons@2.1.4/css/boxicons.min.css')
        ->template('<i class="{ ICON }"></i>', 'text-xl', 'text-sm')
        ->icons([
            "bx bx-accessibility",
            "bx bx-add-to-queue",
            "bx bx-adjust"
        ])
        ->replace(['bx ', 'bxs-', 'bxl-', 'bx-'])
        ->save();
}
```

than you need to clear cache by use this command

```bash
php artisan filament-icons:clear
```

to cache it again use this command


```bash
php artisan filament-icons:install
```

you can try add Box Icons using this snap [Box Icon Snap](https://github.com/tomatophp/filament-icons/blob/master/boxicons-provider-snap.md)

## Publish Assets

you can publish views file by use this command

```bash
php artisan vendor:publish --tag="filament-icons-views"
```

## Publish Config

you can publish config file by use this command

```bash
php artisan vendor:publish --tag="filament-icons-config"
```

## Other Filament Packages

Checkout our [Awesome TomatoPHP](https://github.com/tomatophp/awesome)