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(1mo ago)412ShellCI 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 1mo ago

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

DiceBear Definitions
====================

[](#dicebear-definitions)

Note

This project is still in beta stage and will only be used in future versions of DiceBear.

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**

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

**PHP**

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

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

Development
-----------

[](#development)

Tests require [Bowtie](https://docs.bowtie.report) and a container runtime (Docker or Podman).

```
# Install uv (if not already installed)
brew install uv

# Install Bowtie
uv tool install bowtie-json-schema

# Install dependencies
npm install

# Validate definition files against the schema
npm test
```

Publishing
----------

[](#publishing)

**npm**

Releases are published to npm automatically via GitHub Actions when a version tag is pushed.

```
npm version patch   # 1.0.0 → 1.0.1
npm version minor   # 1.0.0 → 1.1.0
npm version major   # 1.0.0 → 2.0.0

git push origin main --follow-tags
```

`npm version` updates `package.json`, creates a commit, and creates the Git tag in one step. The [publish workflow](.github/workflows/publish.yml) will then install dependencies, run the tests, and publish the package to npm with provenance.

**Packagist**

Once the repository is linked on [packagist.org](https://packagist.org), new releases are picked up automatically from the same Git tags — no separate step needed.

License
-------

[](#license)

The avatar styles are licensed under different licenses. More information can be found in the file [LICENSE.md](./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

37

—

LowBetter than 83% of packages

Maintenance91

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity32

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

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0f19a1a330129371d1655dc823c112265472923f15f8d56ea84777d71c21fcc?d=identicon)[FlorianKoerner](/maintainers/FlorianKoerner)

---

Top Contributors

[![FlorianKoerner](https://avatars.githubusercontent.com/u/647303?v=4)](https://github.com/FlorianKoerner "FlorianKoerner (74 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

[abm/sassphp

PHP bindings to libsass - fast, native Sass parsing in PHP!

559.2k](/packages/abm-sassphp)[mmirus/acf-flexible-content-title

Display the content of a field in the title bar of your Advanced Custom Fields flexible content sections.

362.8k](/packages/mmirus-acf-flexible-content-title)

PHPackages © 2026

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