# boringdesigners/boring-avatars

Boring avatars is an open source React library that generates custom, SVG-based avatars from any username and color palette.

Repository: https://github.com/boringdesigners/boring-avatars
Canonical: https://ross.abutalabs.com/products/boring-avatars
Homepage: https://boringavatars.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: react, javascript, svg, avatar, avatar-component, avatar-generator, avatar-service, avatar-placeholder, random-avatars, avatars-constructor, beautiful-avatars, open-source
Last push: 2026-06-19T16:39:01+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 88, release rhythm 37, longevity 100
- inputs: {"age_days": 2079, "days_push": 75, "days_rel": 343, "gap_med": 38.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6379, forks 214 (observed 2026-08-28T04:09:42.945712+00:00)

## What it is
Boring Avatars is a small open-source React library that generates unique, SVG-based avatars from any username, email, or random string, with customizable color palettes and visual variants. A companion subscription API service is offered for large-scale avatar generation outside React.

## Use cases
- generate profile pictures for users without uploads
- placeholder avatars for new user signups
- deterministic avatars from usernames or emails
- customizable SVG avatars in a React app
- replace gravatar with self-generated avatars
- generate avatars at scale via an API

## When to choose
- you need lightweight, dependency-free SVG avatars in React
- you want deterministic avatars derived from a name or email
- you need multiple visual styles (marble, beam, pixel, sunset, ring, bauhaus) and custom color palettes

## When to avoid
- you need avatars from uploaded photos or image processing
- your stack is not React and you don't want to use the paid API service
- you need raster formats like PNG or JPEG output

## Facets
- artifact type: library
- maturity: active
- function: ui-components, image-processing, frontend-framework
- domain: web-development, frontend, web-design
- platform: -
- tags: svg, avatar-generator, react-component, profile-picture, placeholder-avatars, react, javascript, web-server, nodejs

## Member repositories
- boringdesigners/boring-avatars (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:42.945712+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:45:09.751654+00:00, confidence not recorded.
  - readme: https://github.com/boringdesigners/boring-avatars (fetched 2026-08-28T04:09:42.945712+00:00, sha 4d44b9135517)
  - homepage: https://boringavatars.com (fetched 2026-08-29T08:42:20.402182+00:00, sha a0115dbc12a2)
  - registry_npm: https://registry.npmjs.org/boring-avatars (fetched 2026-08-29T08:42:20.404667+00:00, sha a9790c64c03c)
- Data as of 2026-08-30T08:39:29.467469+00:00.