NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2094 most downloaded on Packagist
Turn name, email, and any other string into initial-based avatar or gravatar.
Latest stable
8.0.2
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Some releases are documented
notes for 28 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
65 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
`toSvg()` escapes the initials and the colour and font-family attribute values. Initials that contain &, < or quotes now produce valid SVG; for exampl
toSvg() escapes the initials and the colour and font-family attribute values. Initials that contain &, < or quotes now produce valid SVG; for example A& is written as A& (#214).max_storage_mb = 0 means no quota, as config/config-hd.php documents. Before, cleanup treated it as a zero-byte quota and deleted stored avatars; getStorageStatistics() now reports 0.0 usage instead of dividing by zero (#214).getCachedUrl() reuses its stored file. The lookup and the write now use the same path ({hash}_{size}.{format}), so each call no longer writes a new file (#214).HDAvatar::createSpriteSheet() no longer fails on the missing Storage import (#214).GITHUB_TOKEN in CI (#213); Dependabot 14-day cooldown (#211).No API changes. composer update laravolt/avatar.
Full Changelog: https://github.com/laravolt/avatar/compare/8.0.1...8.0.2
Authenticated pages return 500 on Laravel 13 with a persistent cache (database, file, redis). toBase64() cached intervention/image's DataUri object in
Your coding agent can read these notes before it upgrades. Set up the MCP server →
toBase64() cached intervention/image's DataUri object instead of a string. Laravel 13's default cache.serializable_classes = false restores it as __PHP_Incomplete_Class, so the second call threw a type error. The base64 avatar is now cached as a string, and stale non-string entries are regenerated (#210).No API changes. composer update laravolt/avatar.
Laravel 10 and 11 are no longer supported, and the floor excludes framework versions affected by CVE-2026-114509 / GHSA-f9x3-7vq9-cph6 (critical) (#20…
illuminate/support is now ^12.68|^13.29. Laravel 10 and 11 are no longer supported, and the floor excludes framework versions affected by CVE-2026-114509 / GHSA-f9x3-7vq9-cph6 (critical) (#206, #207).^8.3 (was >=8.3) (#206).No public API changes. Upgrading from 7.x only requires an app on Laravel 12.68+ or 13.29+.
Full Changelog: https://github.com/laravolt/avatar/compare/7.0.0...8.0.0
Dropped support for PHP 8.2 — minimum PHP version is now 8.3
toBase64(): cacheKey() was computed before buildInitial() ran, so every avatar shared an empty-initials key and produced duplicate cache entries. buildInitial() is now called before the key is computed (#182, #202)composer.json now requires PHP >= 8.3, matching the intervention/image v4 requirement, so prefer-lowest/prefer-stable resolve consistently (#198)Full Changelog: https://github.com/laravolt/avatar/compare/6.5.1...7.0.0
fix: changed alignment from middle to center by @dotmarn in https://github.com/laravolt/avatar/pull/191
Full Changelog: https://github.com/laravolt/avatar/compare/6.5.0...6.5.1
Migrate to Intervention Image v4 by @olivervogel in https://github.com/laravolt/avatar/pull/181
Full Changelog: https://github.com/laravolt/avatar/compare/6.4.0...6.5.0
Laravel 13.x Compatibility by @laravel-shift in https://github.com/laravolt/avatar/pull/179
Full Changelog: https://github.com/laravolt/avatar/compare/6.3.1...6.4.0
Export hd avatar as image for storage by @qisthidev in https://github.com/laravolt/avatar/pull/172
Full Changelog: https://github.com/laravolt/avatar/compare/6.2.0...6.3.1
feat: implement configurable avatar caching by @ramaID in https://github.com/laravolt/avatar/pull/170
Full Changelog: https://github.com/laravolt/avatar/compare/6.1.3...6.2.0
fix/upgrading phpunit to 11 by @ramaID in https://github.com/laravolt/avatar/pull/169
Full Changelog: https://github.com/laravolt/avatar/compare/6.1.2...6.1.3
Fix parameter.implicitlyNullable for PHP 8.4 compatibility. by @cjavad in https://github.com/laravolt/avatar/pull/168
parameter.implicitlyNullable for PHP 8.4 compatibility. by @cjavad in https://github.com/laravolt/avatar/pull/168Full Changelog: https://github.com/laravolt/avatar/compare/6.1.1...6.1.2
Add responsive property to help with SVG generation by @skeemer in https://github.com/laravolt/avatar/pull/163
Full Changelog: https://github.com/laravolt/avatar/compare/6.1.0...6.1.1
Update Gravatar hashing to use sha256 (tests fixed) by @jom in https://github.com/laravolt/avatar/pull/159
Full Changelog: https://github.com/laravolt/avatar/compare/6.0.0...6.1.0
Breaking: Drop support for PHP 8.0
Full Changelog: https://github.com/laravolt/avatar/compare/5.1.0...6.0.0
doc: add video tutorial in readme by @shailesh-ladumor in https://github.com/laravolt/avatar/pull/147
Full Changelog: https://github.com/laravolt/avatar/compare/5.0.0...5.1.0
Add support for PHP 8.2 and Laravel 10
Full Changelog: https://github.com/laravolt/avatar/compare/4.1.7...5.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support to use foreground and background border colors for svgs
Change default image driver to gd.
gd.getAttribute($attribute)Nothing published for this version
Nothing published for this version
change setBorder() signature: add third (optional) parameter $radius
border.radius configNothing published for this version
fix default theme initialization
Nothing published for this version
Fix https://github.com/laravolt/avatar/issues/86
Nothing published for this version
fix https://github.com/laravolt/avatar/issues/85 and https://github.com/laravolt/avatar/issues/79
Drop support for Laravel 5.2, 5.3, 5.4, and 5.5
setTheme()* Add setChars() #75
setChars() #75* Add gravatar support
Add functionality to set custom font-family for SVG.
Add functionality to set custom font-family for SVG.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
remove font folder publishing (Laravel version)
setFontFolderfonts config only accept full pathtoSvg()config/avatar.php to config/laravolt/avatar.phpNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Change: random color generated from $name (previously $initials)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.