- How do I install cmdinglasan/filament-boring-avatars in a Laravel Filament app?
- Install it with Composer using composer require cmdinglasan/filament-boring-avatars. Publish any configuration file if the package README documents one, then use the avatar component in your Filament tables, forms, or infolists. Check Composer resolution against your existing Filament and Laravel versions before deploying.
- Which Filament versions does filament-boring-avatars support?
- The package overview targets Filament v2 by changing the default avatar URL provider to Boring Avatars. Validate the exact Filament and PHP constraints in its composer.json before installing. If you are on Filament v3 or v4, test integration in a branch rather than assuming support.
- Does this package generate avatars on the server or use an external API?
- Boring Avatars are generated as deterministic SVGs, so the package does not rely on an external avatar image service. That keeps avatar rendering privacy-friendly and avoids third-party uptime or rate-limit concerns. Server-side SVG generation is lightweight but can add CPU overhead, so cache rendered avatars on high-traffic pages.
- Can I customize the avatar variant, colors, and size?
- The package is described as supporting configurable variants, colors, and sizes for Boring Avatars. Publish the package config if available and set the palette, variant, and size values to match your Filament panel. Keep the seed stable so users do not see avatars change unexpectedly.
- Are Boring Avatars deterministic for the same user or model?
- Boring Avatars are deterministic, meaning the same seed such as a user name, email, or model identifier produces the same SVG avatar. This gives consistent avatars across tables, forms, and infolists without storing image files. Changing the seed or avatar configuration can change the output.
- Does filament-boring-avatars cache generated SVG avatars?
- The provided overview does not document built-in avatar caching. Because avatars are generated server-side as SVG, you can add application or response caching keyed by the avatar seed and configuration if you render many avatars. Validate cache invalidation when changing variants, colors, or size settings.
- Is it safe to use user names or emails as avatar seeds?
- Treat user names and emails as untrusted input and validate or normalize them before using them as avatar seeds. Deterministic SVG generation avoids external requests, but you should still guard against oversized inputs and unexpected rendering load. The package should not be treated as a substitute for input validation in your Laravel application.
- How do I upgrade from v1.0.0 to v1.2 of filament-boring-avatars?
- Update the Composer dependency to v1.2 and run composer update in a non-production branch. Review the trait correction in PR #3 and the dependency collision fix in PR #12, because custom trait usage or previous constraints may change behavior. Run your test suite and visually check avatar rendering in tables and forms before deploying.
- Does filament-boring-avatars require Node or JavaScript assets?
- The package is intended for Filament and described as generating SVG avatars, so it appears to be a Composer and PHP package rather than a Node or JavaScript asset pipeline. Confirm in the package README and composer.json whether any publishable assets or build steps are required. If your Filament panel already builds assets, follow the package installation notes to avoid missing configuration.
- What are the alternatives to filament-boring-avatars for Laravel Filament avatars?
- Alternatives include Gravatar or UI Avatars services, uploaded profile photos, or custom SVG avatar generators built into your Laravel app. This package is aimed at teams that want deterministic, privacy-friendly avatars without relying on external image services. Compare maintenance, caching needs, and Filament version compatibility before choosing.