README

Local initials avatars for Filament panels, generated as inline SVG data URIs. No third-party services, no HTTP routes, GDPR-friendly.

Requirements

• PHP 8.5+
• Filament 5.x

Installation

composer require tempi-marathon/filament-local-avatars

Register the plugin on your panel:

use TempiMarathon\FilamentLocalAvatars\FilamentLocalAvatarsPlugin;

return $panel
    // ...
    ->plugin(FilamentLocalAvatarsPlugin::make());

The plugin sets the panel's default avatar provider automatically.

Configuration

Publish the config file (optional):

php artisan vendor:publish --tag=filament-local-avatars-config

Available options in config/filament-local-avatars.php:

Local development

When developing the package alongside a consumer app, add a Composer path repository:

"repositories": [
    {
        "type": "path",
        "url": "../filament-local-avatars",
        "options": { "symlink": true }
    }
]

composer require tempi-marathon/filament-local-avatars:@dev

Testing

composer test

Runs Pint, PHPStan (max level), and Pest with a minimum 90% code coverage requirement.

License

MIT. See LICENSE.