wi-wissen/boring-avatars

Boring Avatars are tiny PHP Classes that generates custom, SVG-based avatars from any username and color palette like https://github.com/boringdesigners/boring-avatars.

dev-main 2023-01-01 09:49 UTC

This package is auto-updated.

Last update: 2025-06-29 02:16:51 UTC


README

Boring avatars are tiny PHP Classes that generates custom, SVG-based avatars from any username and color palette like boringdesigners/boring-avatars.

Installation

composer require wi-wissen/boring-avatars

Usage

You can use the classes directly to get SVG as string:

use BoringAvatars\AvatarBeam;

AvatarBeam::make([
    'name' => 'Jane Doe',
    'size' => '120', // in px
    'colors' => ['#ffad08',' #edd75a',' #73b06f',' #0c8f8f',' #405059'],
    'title' => true, //set name property as title tag in generated svg
    'square' => false,
]);

Or serve them using index.php:

http://boringavatars.test/?variant={bauhaus|beam|marble|ring|text}&name=Jane Doe&size=120&color=#ffad08,#edd75a,#73b06f,#0c8f8f,#405059&title=true&square=false