API service Palettes

Boring Avatars

Avatar 1 Avatar 2 Avatar 3 Avatar 4 Avatar 5 Avatar 6 Avatar 7 Avatar 8 Avatar 9 Avatar 10 Avatar 11

Boring avatars is an open source React library and API service that generates unique SVG-based avatars from usernames and color palettes.

Credit to Boring Avatars

Ported Boring Avatars to Java and Spring boot.

If you'd like to contribute here or have a bug, please email .

API service

Usage

During the checkout process, we will ask you for the domain where you will use the API (Up to 1 production and 1 development domain per plan). After the payment is completed, we will create a custom endpoint domain specifically for your needs. You will receive an email with all the necessary information and instructions within 24 hours to get started.

With the custom domain, you can generate avatars by using the following URL:

        https://avatars.legitgames.io?name={NAME}&variant={VARIANT}&size={SIZE}&colors={COLORS}&square

Use the URL in an img tag to display the avatar in your application.

        <img src="https://avatars.legitgames.io/api/avatar" crossorigin/>

Use the crossorigin property to make sure the request uses CORS headers.

Props

Name

The name parameter is used to generate the avatar. It can be the username, email or any random string.

        https://avatars.legitgames.io/api/avatar?name=Maria%20Mitchell
Avatar 8

Variant

The variant parameter is used to change the theme of the avatar. The available variants are: marble, beam, pixel, sunset, ring, bauhaus and initial.

        https://avatars.legitgames.io/api/avatar?variant=beam
Avatar 8

Size

The size parameter is used to change the size of the avatar.

        https://avatars.legitgames.io/api/avatar?size=80
Avatar 8

Colors

The colors parameter is used to change the color palette of the avatar.

        https://avatars.legitgames.io/api/avatar?colors=264653,2a9d8f,e9c46a,f4a261,e76f51
Avatar 8

Square

The square parameter is used to make the avatar square.

        https://avatars.legitgames.io/api/avatar?square
Avatar 8

Initial

If you need an image with your initials in the background, use initial variant. 

        https://avatars.legitgames.io/api/avatar?variant=initial&square&name=Legit%20Games
Legit Games

Random

If you just want to use random avatars without providing usernames, you can use the root endpoint. You will receive an SVG image with a 80*80px size and the marble variant.

        https://avatars.legitgames.io/api/avatar
Avatar 8