I would like to introduce you to two new avatar styles. 🎉

Say hello to dylan!

This avatar style is a remix of: Dylan! The Avatar Generator by Natalia Spivak, licensed under CC BY 4.0.

Documentation | Playground | Editor

And you might also like colourful glass?

Licensed under CC0 1.0 .

You can make it even more colourful with backgroundType = gradientLinear

Documentation | Playground

This release adds support for the WebP and AVIF image formats. The JS library, the HTTP API, and the command line API support the new image formats.

We support WebP and AVIF as modern alternatives to PNG and JPEG. WebP and AVIF can be used on platforms that support these newer file formats but do not support SVG due to security policies.

HTTP-API

https://api.dicebear.com/9.x/lorelei/webp

https://api.dicebear.com/9.x/lorelei/avif

JavaScript

import { toWebp, toAvif } from '@dicebear/converter';
import { createAvatar } from '@dicebear/core';
import { lorelei } from '@dicebear/collection';

const avatar = createAvatar(lorelei);

// WebP
const webpBuffer = await toWebp(avatar).toArrayBuffer();

// AVIF
const avifBuffer = await toAvif(avatar).toArrayBuffer();

Command-line API

# webp
dicebear lorelei --format webp

# avif
dicebear lorelei --format avif

This release fixes a compatibility issue with Next.js caused by the converter that can convert generated SVG avatars to PNG and JPEG. As of this version, the converter is no longer part of the core library and must be installed separately.

Breaking changes

• toDataUri is now synchronous and toDataUriSync has been removed accordingly.

• toPng and toJpeg have been removed. These functions can still be used if the @dicebear/converter library is installed, which provides these two methods.

  Before:

  import { createAvatar } from '@dicebear/core';
  import { bottts } from '@dicebear/collection';
  
  const avatar = createAvatar(bottts);
  const png = await avatar.toPng();

  After:

  import { createAvatar } from '@dicebear/core';
  import { bottts } from '@dicebear/collection';
  import { toPng } from '@dicebear/converter';
  
  const avatar = createAvatar(bottts);
  const png = await toPng(avatar);

  See Documentation for more information.

• toFile has been removed as the behaviour of the function cannot be kept consistent across the environments. Such a method must be implemented yourself.

• toArrayBuffer for SVG format has been removed.

New features

• toPng and toJpeg now support fonts as an option to set custom fonts. See Documentation for more information.

A major update with a small fix that changed the output of the avatars in some
cases. As soon as a fix changes the output of the avatars, we release a major
update to ensure that the avatars of a major version remain consistent. This
update is backwards compatible and should not cause any issues.

A bug with random backgrounds has been fixed. These were not consistent between
browsers due to their implementation. This problem has been fixed and the
backgrounds should now be calculated identically in all browsers.

Further information on this bug can be found in this issue:
#394

New Features:

• Avatar style "rings" (Licensed under CC0 1.0):
  Introducing a brand new avatar style called rings, which gives your avatars a unique and captivating look. With this addition, you have even more creative freedom to create different avatars to suit the needs of your application.

  

• HTTP API Endpoint for Avatar Style JSON Schema:
  In response to user feedback (#337, #341), we have implemented an HTTP API endpoint that provides the JSON schema for each avatar style. You can access this endpoint using the following URL pattern: https://api.dicebear.com/7.x/<style>/schema.json.

Bugfixes:

• Fixed probability calculation (#315):
  We've fixed a problem with the likelihood calculation. Now when the likelihood is set to zero, the library will consistently return false as expected.

As always, we appreciate your support and feedback.

New avatar styles

Notionists is a hand drawn avatar style under CC0 1.0 by @heyzoish.

First of all, I want to give a big shout out and thank you to Zoish for her amazing work and support! ✨
Maybe you guys will leave a follow or a coffee.

Notionists

Documentation | Playground | Editor

Notionists Neutral

Documentation | Playground | Editor

Changes

@dicebear/core

• [BREAKING CHANGE] Requires Node.js 16 or higher
• [BREAKING CHANGE] Optional dependency @resvg/resvg-js updated to ^2.4.1
• [BREAKING CHANGE] Optional dependency exiftool-vendored updated to ^21.2.0
• [BREAKING CHANGE] Optional dependency sharp updated to ^0.31.3

@dicebear/avataaars

• [BREAKING CHANGE] #274 Spelling of beardMajestic fixed
• [BREAKING CHANGE] Option value eyepatch has been moved from option top to accessories
• Fixed: #274 Accessories and facial hair now work without hair
• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/avataaars-neutral

• Added: Option value for accessories named eyepatch

@dicebear/big-ears

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/big-ears-neutral

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/big-smile

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/bottts

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/bottts-neutral

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/croodles

• Removed: Red contrast color

@dicebear/micah

• Added: Option value for eyes named smilingShadow
• Added: Option facialHairColor
• Fixed: Mouth color on black facial hair
• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/personas

• Fixed: #287 SVG masks optimized for use with react-native and resvg

@dicebear/pixel-art

• Added: Hats! 👒
• Fixed: Optimized facial hair color
• Fixed: #287 SVG masks optimized for use with react-native and resvg

HTTP-API

• Deprecated: Versions 5.0, 5.1, 5.2 and 5.3 will be removed mid 2024. See: https://www.dicebear.com/how-to-use/http-api#versioning

Just a small update with a new option called randomizeIds to randomize the IDs in the generated SVG / XML. This can be useful for example if the avatars are included directly in the HTML and you want to avoid ID collisions.

This feature was enabled by default in previous versions and could not be disabled. However, it was implemented in such a way that it would generate IDs that were predictable. This caused problems when the same avatar was included twice on a page.

Have you seen the new avatar styles in the 5.2 release notes? 😅 🥳

Thumbs

Documentation

Shapes

Documentation