vercel/avatar

💎 Beautiful avatars as a microservice

avatar

Generate beautiful gradient avatars for your application.

Usage

Provide a username to generate an avatar. Each name will generate a unique avatar. Just replace rauchg with an username or email:

https://avatar.vercel.sh/rauchg

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

Custom Size

https://avatar.vercel.sh/rauchg?size=30

SVG

Add the extension .svg:

https://avatar.vercel.sh/rauchg.svg

Add Initials

Add the text parameter (requires SVG):

https://avatar.vercel.sh/rauchg.svg?text=GR

avatar's Issues

SVG format doesn't respect size attribute.

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

When both size and type arguments are given, the format is correct (SVG), but the size of the SVG is not changed by the "500" which is being passed in.

Fix:

Change https://github.com/tobiaslins/avatar/blob/master/src/svg.js#L3 so that width="120" height="120" is changed to width="[size]" height="[size]"

File extension influences avatar

This bug doesn't occur with GET parameters, only with custom extensions.

https://avatar.tobi.sh/timo.jpg

https://avatar.tobi.sh/timo.png

Using your service in a fun little Rust CLI app

👋 thanks for this service, it gave me the idea to write a bit of Rust so I have a fresh gradient as my avatar every day.

size=20000 gives an error

maybe it makes sense to add an upper limit and cut at that
so
if(size>upperLimit) size=upperLimit;

Since migration from avatar.tobi.sh the text attribute is missing from the avatar

https://avatar.tobi.sh/tobiaslins.svg?text=TL would generate an avatar with the initials "TL" in white letters on top of the gradient. The new Docs even describe this behavior, but it is simply missing completely.

CUID as seed creates mostly one gradient.

I am using CUIDs for my app, and wanted to use vercel/avatar to generate avatars for my users based on those CUIDs, to avoid storing images. I implemented this but then noticed that it seemed to often give one specific gradient (red/green), rather then a variety of different ones. Unfortunately, the gradient that it gives is pretty ugly.

The CUIDs to generate this image can be found here: https://gist.github.com/cursecodes/4b48449a5b7a526615f51e57e6cd6013

I am assuming this has something to do with djb2, but I have no clue.

Size can only be a square

size=300 returns a 300x300 image while size=300x300 returns a 120x120px image.
It would be nice to set width as well as the height.

Image Generation No Longer working

It seems that since #45 image generation has ceased to work. Even the homepage does not look to be working correctly.

Add heroku upload button.

I think you should add a Heroku Easy Setup Button for easy installation.
What do you think @tobiaslins ?

Single-letter text not vertically centered

Also, is it possible to set the font size?

Broken in gmail

Gmail does not seem to support these avatars / svg images. Are there any solutions or workarounds for this?

Use without api in nodejs.

I'd like to use this in node so If possible can you please export the functions :
generateSVG
generatePNG
and publish the package to npm? it'd be super helpful. :)

image not being displayed / broken

the third avatar image not being displayed on the webpage .

To recreate :
visit https://avatar.vercel.sh/

Unable to deploy to Heroku

Apparently you need to specify a Node version in the package.json to enable heroku deploys:

-----> Build failed
       
       We're sorry this build is failing! You can troubleshoot common issues here:
       https://devcenter.heroku.com/articles/troubleshooting-node-deploys
       
       Some possible problems:
       
       - Node version not specified in package.json
         https://devcenter.heroku.com/articles/nodejs-support#specifying-a-node-js-version
       
       Love,
       Heroku

first letters of the name also with the image in png format

Hello everyone!

Is it possible to get an avatar with the first letters of the name also with the image in png format ? Currently it's possibile to do that only with svg file: