Contribute to the library

DiceBear is maintained across several repositories on GitHub. Each repo has its own CONTRIBUTING.md with setup, scripts, testing, and release instructions. Pick the one that matches what you want to work on.

Avatar styles

New avatar styles and fixes to existing styles live in dicebear/styles. Most styles are authored in Figma and exported with the DiceBear Exporter plugin, so the workflow there is not the usual "edit a JSON file" loop.

• CONTRIBUTING.md in dicebear/styles

Core library, CLI, documentation, editor

The JavaScript, PHP, Python, Rust and Go cores, the CLI, the VitePress documentation (including the Playground), and the standalone editor all live in the main dicebear/dicebear monorepo. See:

• CONTRIBUTING.md in dicebear/dicebear

It covers the monorepo layout, per-package workflow, cross-language parity tests across the JavaScript, PHP, Python, Rust and Go cores, and the release process.

JSON Schema

The schema for avatar style definitions and runtime options is versioned separately in dicebear/schema.

• CONTRIBUTING.md in dicebear/schema

Figma exporter plugin

The Figma plugin that produces new avatar style definitions lives in dicebear/exporter-plugin-for-figma.

• CONTRIBUTING.md in dicebear/exporter-plugin-for-figma