dicebear_styles 10.2.0

Definition files of the DiceBear avatar styles, embedded as Dart string constants.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

This repository ships the DiceBear avatar styles as pure JSON definition files (distributed via npm, Composer, PyPI, crates.io, Go modules, and pub.dev). Versions track the DiceBear release line.

Unreleased

Added

• Dart: The styles are now available as a dicebear_styles package on pub.dev. Dart has no compile-time file embedding, so scripts/build.sh generates one library per style with the raw JSON as a string constant (e.g. package:dicebear_styles/adventurer.dart); a compiled app only embeds the styles it imports. The umbrella library dicebear_styles.dart re-exports every style and adds get(name) and all, so the Dart, Rust and Go shims share one API. Each generated file credits its style's artist and license. The generated lib/ is git-ignored (like the npm dist/) and built fresh by the test and publish workflows; tool/check_parity.dart proves in CI that every embedded constant is byte-identical to its src/*.json source.

10.2.0 - 2026-06-08

Added

• Go: The styles are now available as a Go module (github.com/dicebear/styles/v10). Each style is embedded and exposed as an exported string variable and via Get(name)/All(). Generated by scripts/build.sh alongside the Rust shim.

Changed

• Rust (breaking): Renamed enabled() to all(), so the Rust and Go shims share one API (<Style> constant/variable + get(name) + all()/All()). We normally follow Semantic Versioning strictly, which would make this a major bump. We make a one-time exception here: the crate had only just been uploaded to crates.io and was never promoted or officially announced, so it had no real-world users to break. Renaming now (before adoption) buys a clean, cross-language API rather than carrying a misnamed function (or a deprecated alias) forever.

10.1.0 - 2026-06-03

Added

• Rust distribution: A dicebear-styles crate is now published to crates.io, alongside the existing npm, Composer, and PyPI distributions. It embeds the same JSON style definitions via include_str!, gated behind one Cargo feature per style, and exposes each as a &'static str constant plus get(name)/enabled() lookup helpers.

Changed

• Schema: All style definitions now reference @dicebear/schema@1.1.0 (previously 1.0.0).

Fixed

• Lorelei: The mouth is now visible through beard variants. The masking group overlaying the mouth on beards was rendered at 0 opacity (fully hidden) and is now at 0.4, matching the intended design.
• Rings: Now uses the default shape-rendering instead of crispEdges, so the rings render with smooth anti-aliased edges.
• Packaging: The published packages now reference LICENSE.md in the package.json files field, so the license is included in the npm tarball.

10.1.0-rc.1 - 2026-05-31

Added

• Python distribution: A dicebear-styles package is now published to PyPI, alongside the existing npm and Composer distributions, exposing the same JSON style definitions to Python consumers.

10.0.0 - 2026-05-27

See the v10.0.0 release notes.

Added

• 6 new avatar styles: Disco, Glyphs, Initial Face, Shape Grid, Stripes, and Triangles.
• Composer distribution: Style definitions are now published to Packagist so the PHP library can consume them.

Changed

• Each avatar style is now stored as a JSON definition file (built to a minified *.min.json) instead of TypeScript/JavaScript code, separating licensing and artwork concerns from implementation.