💎 Beautiful avatars as a microservice
JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.dockerignore
.gitignore
Dockerfile
README.md
licence.md
package.json
yarn.lock

README.md

avatar

Avatar generates beautiful gradient avatars for your app or homepage (for example if they didn't upload one)

Avatar is built on top of micro and is hosted on Heroku

How to use avatar

To generate an avatar just embed following URL https://avatar.tobi.sh/. Now you can append a username to generate an avatar

You will receive a png image with a size of 120*120px

Each name will generate a unique avatar. Just replace tobiaslins with an username or email

PNG avatar

https://avatar.tobi.sh/tobiaslins

Avatar for tobiaslins

Custom size

https://avatar.tobi.sh/tobiaslins?size=30

Avatar for tobiaslins

SVG avatar

It is possible to receive an svg avatar by adding the extension .svg or the parameter type=svg

https://avatar.tobi.sh/tobiaslins.svg
https://avatar.tobi.sh/tobiaslins?type=svg

Random avatar

If you just want to use random avatars without providing usernames, you can use the root endpoint

https://avatar.tobi.sh/

Random Avatar

Usecase

Are you creating a new app/website with an user system?

If your user doesn't want to load a custom profile picture - you can show him a unique generated avatar