# DESIGN.md · DiceBear (AV-001)

> Written for AI coding agents. Values marked **OFFICIAL** come from the documented source named below; values marked **ESTIMATED** were measured by us from our own screenshots and are approximate. Never treat ESTIMATED values as official brand tokens.

## Overview
- Type: Avatar Library · Category: J. Avatars and Illustrations
- Platforms: Web
- Color theme: Monochrome light · Layout pattern: Split hero · Mood: Friendly, developer-focused
- License / terms: Code: MIT. Styles: each artist’s own license: 42 CC0 1.0, 14 CC BY 4.0, 1 MIT, 4 ‘free for personal and commercial use’ (see dicebear.com/licenses). Public HTTP API: free for non-commercial use, rate-limited

Avatar generator with 60+ styles, deterministic from a seed (e.g. a user ID). Use it via the HTTP API, JS library, CLI or Figma plugin. For commercial use or higher limits, self-host the API or use the JS library.

### Analysis (ours)
Captured dicebear.com: split hero with “Pick a seed. Get an avatar.” on the left and a cluster of sample avatars on the right; near-white UI so the avatars carry the color.

## Color tokens
No official color tokens documented for this entry.

ESTIMATED · dominant colors measured from our screenshot(s) of the source site (median-cut quantization; share = % of pixels). Approximate, not official:

- `#FAFAF9` ~59%
- `#868887` ~5%

## Typography
No official type scale documented for this entry; use the product’s own typography guidance.

## Spacing, radii, shadows
Not documented for this entry. Do not invent values; derive from your own design system.

## Components
No component inventory documented for this entry.

## Layout rules
- Observed layout pattern: **Split hero** (from our captures).

## Usage
```
HTTP API: https://api.dicebear.com/10.x/lorelei/svg?seed=user-8f3a2c
JS: import { createAvatar } from '@dicebear/core'; import { lorelei } from '@dicebear/collection'; const svg = createAvatar(lorelei, { seed: 'user-8f3a2c' }).toString();
```

## Do’s and don’ts
- Do: Keep chrome neutral and let content (images, icons, type) carry color.
- Don’t: Don’t introduce decorative color that competes with content.
- Do: follow the source’s license/terms listed above.
- Don’t: present ESTIMATED colors as official tokens.

## Sources
- https://www.dicebear.com/
- Library entry: https://design-library-byt.pages.dev/entry/AV-001