Geometric mosaic avatars

Mosaico is one of the 13 original lazy-avatars collections. Arcs and triangular tiles form a geometric identicon for profiles and teams.

Mosaico avatar example

When to use Mosaico

Use it for abstract identities in member lists and comments.

Install and render

npm install lazy-avatars@1.1.2
import { createAvatar } from 'lazy-avatars';
import { mosaic } from 'lazy-avatars/mosaic';

const svg = createAvatar(mosaic, {
  seed: 'Ada Moss',
  size: 64,
  shape: 'rounded',
  options: { tile: 'arcs' },
});

This code demonstrates explicit collection options. The preview uses seed-selected defaults (Rack: demo-host-01 with status warn); changing options can change its appearance.

React integration

Install React 19 separately, then pass this collection to the optional component:

import { Avatar } from 'lazy-avatars/react';
import { mosaic } from 'lazy-avatars/mosaic';

<Avatar collection={mosaic} seed="Ada Moss" size={64} title="Example profile" />;

Determinism and license

Same collection/output version, normalized seed and effective options produce identical SVG bytes. Collection outputVersion is 1. Pin the package or save the SVG to preserve historical output. Original artwork and code use this project's MIT license; no third-party fonts are bundled.

Try Mosaico in the interactive gallery · Full API contract

Other collections