Boring avatars is a tiny JavaScript React library that generates custom, SVG-based, round avatars from any username and color palette.

yarn add boring-avatars

or

npm install boring-avatars

import Avatar from "boring-avatars";

<Avatar
  size={40}
  name="Maria Mitchell"
  variant="marble"
  colors={["#92A1C6", "#146A7C", "#F0AB3D", "#C271B4", "#C20D90"]}
/>;

You can embed your boring avatars using the boring avatars source.

To choose a random avatar from a specific user and a color palette, the format follows:

https://source.boringavatars.com/marble/120/Maria%20Mitchell?colors=264653,2a9d8f,e9c46a,f4a261,e76f51

For more information, check out the README

To use boring avatars outside of React, check out these alternative implementations.

• Vue
• Laravel Blade
• React Native

If you don't see a port you're looking for, we'd encourage you to create your own.