README

Convenient Font Awesome icons selection field for MoonShine

Support MoonShine versions

Installation

composer require bugo/moonshine-fontawesome-field

Usage

You can use IconSelect field in your resources:

<?php

declare(strict_types=1);

namespace App\MoonShine\Resources;

use Bugo\MoonShine\FontAwesome\Fields\IconSelect;
use MoonShine\Laravel\Resources\ModelResource;
use MoonShine\Contracts\UI\FieldContract;
use MoonShine\Contracts\UI\ComponentContract;

/**
 * @extends ModelResource<Custom>
 */
class CustomResource extends ModelResource
{
    /**
     * @return list<ComponentContract|FieldContract>
     */
    protected function formFields(): iterable
    {
        return [
            IconSelect::make('Icon')
                ->searchable(),
        ];
    }
}

All use cases of Blade Font Awesome are also available for you.

Caching

When using icons in Blade templates, be sure to enable Caching.

How to update icon sets

Once the package is installed, run these commands:

pnpm add @fortawesome/fontawesome-free -D
php artisan moonshine:update-fa-icons

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.