Fin Avatar

• Features
• Installation
• Usage
• Configuration (Optional)
• Credits
• License

A privacy-focused, high-performance avatar provider for Filament V4 and V5. It generates SVGs locally using a dedicated route, ensuring zero external requests (GDPR compliant) and utilizing browser caching for instant loads.

#Features

• Zero External APIs: No data sent to ui-avatars.com or Gravatar.

• Smart Initials: Automatically strips "Mr.", "Dr.", "PhD" etc.

• Theme Aware: Uses your Filament Panel's primary color automatically.

• High Performance: SVGs are cached by the browser for 1 year.

#Installation

You can install the package via composer:

composer require finity-labs/fin-avatar

Running the install command will configure the selected panels automatically:

php artisan finity-labs:install

#Usage

Add in AdminPanelProvider.php:

use FinityLabs\FinAvatar\AvatarProviders\UiAvatarsProvider;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->defaultAvatarProvider(UiAvatarsProvider::class);
}

#Configuration (Optional)

Publish the config file to customize ignored prefixes (like "Mr", "Dr"), default background color and text color:

php artisan vendor:publish --tag=fin-avatar-config

:bulb: Note: Leave default_bg null to use theme color as background.

#Credits

• Finity Labs

#License

The MIT License (MIT). Please see License File for more information.