@dicebear/avatars-code-sprites NPM

license

Usage

HTTP-API (recommended)

Our free HTTP-API is the easiest way to use this sprite collection. Just use the following URL as image source.

https://avatars.dicebear.com/api/code/:seed.svg

The value of :seed can be anything you like - but don't use any sensitive or personal data here! The GET parameter options can be used to pass options.

Examples

preview	url
	https://avatars.dicebear.com/api/code/example.svg
	https://avatars.dicebear.com/api/code/example.svg?options[padding]=1&options[background]=%23f0f0f0

NPM

Install the Avatars and this sprite collection with the following command.

npm install --save @dicebear/avatars @dicebear/avatars-code-sprites

Now you are ready to create your first Avatar.

import Avatars from '@dicebear/avatars';
import sprites from '@dicebear/avatars-code-sprites';

let options = {};
let avatars = new Avatars(sprites, options);
let svg = avatars.create('custom-seed');

Options

name	alias	type	default	description
radius	r	number	`0`	Avatar border radius
base64		bool	`false`	Return avatar as base64 data uri instead of XML Not supported by the HTTP API
width	w	number	`null`	Fixed width
height	h	number	`null`	Fixed height
margin	m	number	`0`	Avatar margin in percent HTTP-API limitation Max value `25`
background	b	string	`null`	Any valid color identifier HTTP-API limitation Only hex (3-digit, 6-digit and 8-digit) values are allowed. Use url encoded hash: `%23`.
userAgent		string	`window.navigator.userAgent`	User-Agent for legacy browser fallback Automatically detected by the HTTP API
type		string	`qr`	Currently only "qr" is supported
color		string	`null`	Any valid color identifier HTTP-API limitation Only hex (3-digit, 6-digit and 8-digit) values are allowed. Use url encoded hash: `%23`.
correctionLevel		string	`M`	Choose from `L`, `M`, `Q`, `H`