JGuang
中

Pixel Art

Pixel Art · DiceBear

Preview
npm install @dicebear/core@9.4.2 @dicebear/collection@9.4.2

Pixel Art

Pixel characters with hats, glasses, clothing and accessories.

Install

npm install @dicebear/core@9.4.2 @dicebear/collection@9.4.2

Generate an avatar

The same seed always produces the same avatar, so a user ID or username works as a seed. Avatars are generated locally without a network service.

import { createAvatar } from '@dicebear/core';
import { pixelArt } from '@dicebear/collection';

// “Pixel Art” by DiceBear, CC0 1.0
const avatar = createAvatar(pixelArt, {
  seed: 'Aria Chen',
  size: 128,
  radius: 50,
});

export const svg = avatar.toString();     // inline SVG markup
export const dataUri = avatar.toDataUri(); // use as an <img> src

React component:

import { useMemo } from 'react';
import { createAvatar } from '@dicebear/core';
import { pixelArt } from '@dicebear/collection';

export function UserAvatar({ seed, size = 64 }: { seed: string; size?: number }) {
  const src = useMemo(() => createAvatar(pixelArt, { seed, size }).toDataUri(), [seed, size]);
  return <img src={src} width={size} height={size} alt={`Avatar for ${seed}`} />;
}

Options

Common options: seed, size, radius, backgroundColor, flip, rotate, scale.

Style options: accessories, accessoriesColor, accessoriesProbability, beard, beardProbability, clothing, clothingColor, eyes, eyesColor, glasses, glassesColor, glassesProbability, hair, hairColor, hat, hatColor, hatProbability, mouth, mouthColor, skinColor.

Full option reference: https://www.dicebear.com/styles/pixel-art/

License and attribution