Generating Random SVG Avatars with NextJS: A Step-by-Step Guide

6 min read

January 13, 2023

Are you tired of using generic profile pictures for your website or application? In this post, we'll show you how to use NextJS to generate unique, random SVG avatar images on the fly. With just a few lines of code, you can add a personal touch to your user profiles and stand out from the crowd.


In this tutorial, we'll be using the NextJS to build custom SVG avatar images. We'll be utilizing the @vercel/og library, which allows us to easily create unique and dynamic images using the power of code.

Using this library, we can easily create customized avatars with different shapes, colors, and styles based on our needs. With NextJS, we'll be able to easily serve these dynamic images to our users, making the process of creating custom avatars both efficient and fun. So if you're ready to add some personality to your user profiles, let's get started!

Prerequisites: Familiarity with NextJS, React, and SVGs

We will be using NextJS version 12 or above. We'll also be working with React, so some understanding of how they work and how they can be used to create UI elements will be helpful. Additionally, we'll be working with SVG images, so having some understanding of the basics of how SVGs are created and how they differ from other image formats will be beneficial. If you are not familiar with any of these technologies, don't worry! There are plenty of resources available online that can help you get up to speed.

Setting up a NextJS Project (optional)

In order to start building custom SVG avatars with NextJS and the @vercel/og library, we first need to set up a NextJS project. If you already have a NextJS project running, you can skip this step and proceed to install the @vercel/og library.

Here's how you can create a new NextJS project:

  1. Create a NextJS app by running the following command in your terminal:
npx create-next-app@latest my-avatars-app --typescript

I am going to be using typescript, but you can do it without typescript if you prefer.

  1. Navigate into your new project's directory by running: cd my-avatars-app
  2. Start the development server by running: npm run dev
  3. Open your browser to http://localhost:3000 and you should see the default NextJS "Welcome to Next.js" page.

Now you have the basic NextJS setup ready and you can start building your custom SVG avatar images using NextJS and @vercel/og library.

Installing the @vercel/og Library and Setting Up the API Endpoint

Now that you have a NextJS project set up, you can install the @vercel/og library and set up an API endpoint that will be used to serve the dynamically generated SVG avatars. Here's what you need to do:

  1. Install the @vercel/og library by running the following command in your project's directory:
npm i @vercel/og
  1. In your pages folder, create a new file called api/avatars.tsx (or .jsx if you are not using TypeScript). Observe that we are using JSX because we are going to be doing some React rendering on the API endpoint.

  2. In the avatars.tsx endpoint import the ImageResponse class from the @vercel/og library and that's it, you are now able to build custom avatars for your users.

Ok, we got it, a pretty bad avatar but it is a starting point. See the image below:

Random SVG avatar with NextJS

Let's now customize the avatars

In this case for simplicity we are going to use some random numbers to generate the avatars. But it can be based on the user email and stored preferences, completely random, based on authentication tokens, etc.

For this example we will just generate random avatars, we will need a function to generate random numbers and one for selecting a random color:

Lastly we can draw a random avatar for the user by tuning the SVG:

Here you can see some results, which are actually hitting the API, you can try it at /api/examples/avatars. If you hit the API multiple times it will cache and return the same avatar. If you want to generate a different avatar you can include a param ?p=<some-random-number>.

Random SVG avatar with NextJS first example Random SVG avatar with NextJS second example Random SVG avatar with NextJS third example Random SVG avatar with NextJS fourth example Random SVG avatar with NextJS fifth example Random SVG avatar with NextJS sixth example

This now looks better, but the Avatars are not persistent, they are cached on Vercel's edge locations, but for storing the parameters (random numbers) that we used for each avatar we would need some kind of storage, there are several options but we will not cover that topic today.


My main goal with the blog post was to learn and explore the @vercel/og library and provide a basic idea of how it can be used for generating something like an Avatar. After playing around with the library for some hours I think it is a great tool and it is really powerful. If you have some kind of need to generate images dynamically I would really recommend that you give it a try.