PHPackages                             dicebear/definitions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. dicebear/definitions

ActiveLibrary[Utility & Helpers](/categories/utility)

dicebear/definitions
====================

Definition files of the DiceBear avatar styles.

v0.1.1(4mo ago)6122ShellCI passing

Since Sep 29Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/dicebear/definitions)[ Packagist](https://packagist.org/packages/dicebear/definitions)[ RSS](/packages/dicebear-definitions/feed)WikiDiscussions main Synced 4mo ago

READMEChangelog (1)DependenciesVersions (5)Used By (0)

DiceBear avatar styles
======================

[](#dicebear-avatar-styles)

This repository contains all official avatar style definitions for [DiceBear](https://www.dicebear.com). An avatar style definition is a JSON file that describes how to create an avatar. It contains all necessary information like available elements and colors. The JSON files are ideal for creating avatars in different programming languages with the corresponding DiceBear wrapper. The JSON schema for the avatar style definitions can be found in the [`@dicebear/schema`](https://github.com/dicebear/schema) package.

Generate definitions
--------------------

[](#generate-definitions)

Most of the JSON files were created using the [DiceBear Exporter](https://www.dicebear.com/guides/create-an-avatar-style-with-figma/)for Figma. The used Figma files are linked in the `figma` folder. Files created with this plugin are marked accordingly and should not be adjusted manually, but exported again with the Figma plugin.

Usage
-----

[](#usage)

**JavaScript**

```
npm install @dicebear/styles
```

```
import adventurer from '@dicebear/styles/adventurer.json' with { type: 'json' };
import lorelei from '@dicebear/styles/lorelei.json' with { type: 'json' };
```

**PHP**

```
composer require dicebear/styles
```

```
$basePath = \Composer\InstalledVersions::getInstallPath('dicebear/styles');

$adventurer = json_decode(file_get_contents($basePath . '/src/adventurer.json'), true);
$lorelei    = json_decode(file_get_contents($basePath . '/src/lorelei.json'), true);
```

**Python**

```
pip install dicebear-styles
```

```
import json
from importlib.resources import files

adventurer = json.loads(files('dicebear_styles').joinpath('adventurer.json').read_text('utf-8'))
lorelei    = json.loads(files('dicebear_styles').joinpath('lorelei.json').read_text('utf-8'))
```

**Rust**

Each style is gated behind a feature of the same name, so a binary only embeds the styles it opts into (use the `all` feature to pull in every style):

```
cargo add dicebear-styles --features adventurer,lorelei
```

The enabled styles are embedded at compile time and exposed as raw JSON (`&'static str`). Parse them with `serde_json`:

```
use dicebear_styles::{ADVENTURER, LORELEI};

let adventurer: serde_json::Value = serde_json::from_str(ADVENTURER)?;
let lorelei: serde_json::Value = serde_json::from_str(LORELEI)?;

// Or look one up by name at runtime (None if unknown or its feature is off):
let style = dicebear_styles::get("adventurer");

// all() lists every style compiled into this build.
let all = dicebear_styles::all();
```

**Go**

```
go get github.com/dicebear/styles/v10
```

Every style is embedded at compile time and exposed as raw JSON (`string`), both as an exported variable and by name via `Get`. Parse it with `encoding/json`:

```
import (
	"encoding/json"

	styles "github.com/dicebear/styles/v10"
)

var adventurer map[string]any
_ = json.Unmarshal([]byte(styles.Adventurer), &adventurer)

// Or look one up by name (ok is false if the style is unknown):
raw, ok := styles.Get("lorelei")

// All() lists every embedded style.
all := styles.All()
```

**Dart**

```
dart pub add dicebear_styles
```

Each style is a Dart string constant in its own library, so a compiled app only embeds the styles it imports. Parse the raw JSON with `dart:convert`:

```
import 'dart:convert';

import 'package:dicebear_styles/adventurer.dart';
import 'package:dicebear_styles/lorelei.dart';

final adventurerStyle = jsonDecode(adventurer);
final loreleiStyle = jsonDecode(lorelei);
```

Or import the umbrella library, which pulls in every style and adds a runtime lookup by name:

```
import 'package:dicebear_styles/dicebear_styles.dart' as styles;

// null if the style is unknown:
final raw = styles.get('adventurer');

// `all` lists every embedded style.
final names = styles.all;
```

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](https://github.com/dicebear/definitions/blob/main/CONTRIBUTING.md)for local development, testing, and the release process.

License
-------

[](#license)

The avatar styles are licensed under different licenses. More information can be found in the file [LICENSE.md](https://github.com/dicebear/definitions/blob/main/LICENSE.md) or in the definition files themselves.

Sponsors
--------

[](#sponsors)

Advertisement: Many thanks to our sponsors who provide us with free or discounted products.

[    ![bunny.net](https://camo.githubusercontent.com/4ae34db3dad914c12edc4dc985f9c62d3d4cde77d4d6de3471bd9211c42ac5c2/68747470733a2f2f7777772e64696365626561722e636f6d2f73706f6e736f72732f62756e6e792d6461726b2e737667) ](https://bunny.net/)

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance83

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~183 days

Total

4

Last Release

139d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/647303?v=4)[Florian Körner](/maintainers/FlorianKoerner)[@FlorianKoerner](https://github.com/FlorianKoerner)

---

Top Contributors

[![FlorianKoerner](https://avatars.githubusercontent.com/u/647303?v=4)](https://github.com/FlorianKoerner "FlorianKoerner (158 commits)")

---

Tags

dicebear

### Embed Badge

![Health badge](/badges/dicebear-definitions/health.svg)

```
[![Health](https://phpackages.com/badges/dicebear-definitions/health.svg)](https://phpackages.com/packages/dicebear-definitions)
```

###  Alternatives

[digilist/snakedumper

4946.0k](/packages/digilist-snakedumper)[fritzmg/contao-sharebuttons

Simple Contao extension to provide share buttons as a module and content element

2233.8k](/packages/fritzmg-contao-sharebuttons)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)