dicebear_styles 10.4.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

10.4.0 - 2026-08-09

Added

• New style: Voxel Bot. The robot sibling of Voxel Art, built on the same voxel projection: a pastel shell, a dark faceplate with glowing LED eyes and mouth, gripper hands, chest panels from heart to cassette slot, and antennas from a radar dish to a siren. The LED color never repeats the shell color. When animated, the eyes power off briefly, the upper body jolts up by one voxel, and the head extends one more off the neck. Hand-authored, CC0 1.0.
• New style: Voxel Art. A chibi character built from voxels, seen almost head-on with the depth receding up and to the right. 76 variants across ten components, from a deep long-hair pool over animal-ear hoods to outfits with checkered jackets and dresses. When animated, the eyes blink and the upper body jolts up by one voxel while the feet stay planted. Hand-authored, CC0 1.0.

10.3.0 - 2026-08-01

Changed

• Moods, Landscape, Clay, Critters: Renamed five variants whose names read as something else out of context. In moods, face: hex is now hexagon, which is also what disco and shape-grid call that shape. In landscape, orb: halo is now glow. The crossed and diverging eyes now say which way the pupils point instead of borrowing clinical terms: clay eyes: cross and eyes: walleyed became inward and outward, and critters eyes: crossEyed became inward. All four styles are release candidates and no stable release ever shipped the old names. Because the variant pool is drawn in alphabetical order, the rename moves these variants within their pool, so a seed in one of these styles can render differently than it did in the previous release candidate.

10.3.0-rc.3 - 2026-07-31

Added

• New style: Clay. A hand-molded plasticine creature on a warm paper backdrop. Fourteen wobbly silhouettes with googly eyes and carved mouths, most seeds with a pinched top or a stamped belly mark. When animated, the body squashes gently and the pupils wobble. Hand-authored, CC0 1.0.

10.3.0-rc.2 - 2026-07-31

Added

• New style: Weave. A woven tartan pattern: two to three translucent bands per axis over a light tinted tile, with the band colors repeating across both axes and a fine accent line per axis. Diagonal on most seeds, straight on the rest. Band positions are continuous, so two seeds practically never share a design. Static by design, it carries no animation component. Hand-authored, CC0 1.0.
• Opt-in animation. All new styles below, as well as Shapes, Glass, Thumbs, and Initial Face, carry an animation component. By default (none) they render fully static. The animationVariant render option selects a speed from fastest to slowest. A static avatar next to an animated one stays static, browsers without CSS :has() support show the static image, and the animations respect prefers-reduced-motion.
• Animation tag. The animated variants carry the bare animation variant tag, so the tags render option can switch the animation on (animation, at a random speed per seed) or keep it off (!animation). The static default variant carries no tag.
• New style: Moods. A lovable character face for product UIs: a big pastel face shape on a deep background, drawn with the shared depth system (cast shadow, light and dark rims). Nine silhouettes, sixteen eye sets (every open eye a white eyeball with an ink pupil), and fifteen thick rounded mouths, plus blush cheeks on half the seeds. The smiling variants have higher weights. When animated, it blinks. Hand-authored, CC0 1.0.
• New style: Critters. A small bug-like creature in shaded pastel on a deep background: fourteen bodies, nineteen eye sets, nineteen mouths, and usually an attachment in a second pastel. When animated, it bobs, blinks, and its horns sway. Hand-authored, CC0 1.0.
• New style: Sprouts. A potted plant with the face on the pot: twelve plants, seven pot shapes, and the Critters face set. When animated, the plant sways and the face blinks. Hand-authored, CC0 1.0.
• New style: Loops. A truchet pattern: quarter-circle arc tiles on a 3x3 grid join into meandering paths. The pattern is tone-in-tone with the background by default, patternVariant switches to plain white or black. When animated, the tiles quarter-turn and keep reconfiguring the pattern. Hand-authored, CC0 1.0.
• New style: Pixelbot. An AI-bot face on a 12x12 LED panel. Unlit cells stay dark, lit pixels draw the face: seven eye sets and five mouths, nine glow colors, ten dark backgrounds. With animation enabled, the eyes blink row by row, the mouths widen, and every pixel switches hard like a real LED. Hand-authored, CC0 1.0.
• New style: Squircles. A depth stack of three to five nested superellipses. Opacity rises toward the center, each layer is jittered and rotated, and a small accent squircle appears on most seeds. Hand-authored, CC0 1.0.
• New style: Blobs. Two to four layered organic forms in white or black over a strong background color. Compositions range from calm concentric stacks to off-center clusters. Hand-authored, CC0 1.0.
• New style: Constellation. A constellation over a deep night sky, drawn from real star data, plus a per-seed star field, an occasional shooting star, and two rare easter eggs. Hand-authored, CC0 1.0.
• New style: Landscape. An abstract layered landscape: four hill bands, an optional sun or moon, and curated nature palettes that keep every random combination harmonious. Hand-authored, CC0 1.0.
• New style: Planets. A single planet over deep space with ten surface variants, an optional ring, moons, and a random star field. shadeVariant switches to a crisp two-tone shading. Hand-authored, CC0 1.0.
• New style: Waves. Three to six translucent wave bands over a saturated background color, freely rotated per seed. rotationVariant locks the direction. Hand-authored, CC0 1.0.

Removed

• Variant tags. The tags introduced in 10.3.0-rc.1 moved to the feat/variant-tags branch and are not part of this release. The schema references stay at @dicebear/schema 1.3.0.

10.3.0-rc.1 - 2026-06-21

Added

• Variant tags. The character styles now describe their variants with tags, so the DiceBear tags render option can filter the variant pool (for example, keep only mood:happy mouths, or drop facial hair with !facialHair). The shared set covers mood, hairLength, hairStyle, headwear, facialHair, eyewear, and accessory. The abstract styles carry no tags. This needs @dicebear/schema 1.3.0, and every definition's $schema reference now points to it.

Fixed

• Re-exported the glasses in adventurer-neutral, the hair in big-smile, and the mouth in croodles and croodles-neutral. This shortens overlong coordinate decimals in the exported paths, for example 42.1899 becomes 42.19.

10.2.0 - 2026-06-08

Added

• Dart: The styles are now available as a dicebear_styles package on pub.dev. The Dart shim landed after the v10.2.0 tag, so the pub.dev release of this version came from a later commit. 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.
• 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.