# dmester/jdenticon

Javascript library for generating identicons. Running in the browser and on Node.js.

Repository: https://github.com/dmester/jdenticon
Canonical: https://ross.abutalabs.com/products/jdenticon
Homepage: https://jdenticon.com
Language: JavaScript
License: MIT
License Family: permissive
Topics: javascript, identicon, avatar, jdenticon, identicons
Last push: 2024-05-10T09:59:32+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4309, "days_push": 845, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1748, forks 119 (observed 2026-08-28T04:05:30.887098+00:00)

## What it is
Jdenticon is a JavaScript library for generating deterministic, highly recognizable identicon avatars from hash values, rendered via HTML5 canvas or SVG. It runs in the browser and on Node.js, with ports available for PHP, .NET, Rust, Swift, and other platforms.

## Use cases
- generate default user avatars from usernames
- render identicon placeholders for users without profile pictures
- create privacy-friendly avatars from email hashes
- generate identicon PNG files on a Node.js server
- add identicons to a website with a single script tag and data attribute
- generate identicons from the command line without writing code

## When to choose
- you need deterministic, hash-based avatar images in JavaScript
- you want both raster (canvas/PNG) and vector (SVG) output
- you need a lightweight, MIT-licensed solution with no server dependencies
- you want consistent identicons across multiple platforms via its ports

## When to avoid
- you need photographic or illustrated avatars rather than geometric patterns
- you need a different identicon style than Jdenticon's blocky symmetric design
- you are not using JavaScript or one of the platforms with an existing port

## Facets
- artifact type: library
- maturity: stable
- function: graphics, image-processing, sdk
- domain: web-development, frontend, graphics, privacy
- platform: browser, cross-platform
- tags: identicon, avatar-generation, svg, canvas, hash-based-icons, nodejs

## Member repositories
- dmester/jdenticon (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:30.887098+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-30T03:28:49.583084+00:00, confidence not recorded.
  - readme: https://github.com/dmester/jdenticon (fetched 2026-08-28T04:05:30.887098+00:00, sha 61e536efb878)
  - homepage: https://jdenticon.com (fetched 2026-08-29T11:07:11.992885+00:00, sha e2f2394421ac)
  - registry_npm: https://registry.npmjs.org/jdenticon (fetched 2026-08-29T11:07:12.001881+00:00, sha 290c50dae988)
  - site_page: https://jdenticon.com/php-api (fetched 2026-08-29T11:07:11.998366+00:00, sha f0fd46f63706)
  - site_page: https://jdenticon.com/net-api (fetched 2026-08-29T11:07:12.000098+00:00, sha 513f2495a026)
  - site_page: https://jdenticon.com/js-api (fetched 2026-08-29T11:07:11.996672+00:00, sha 932a74d10bdd)
- Data as of 2026-08-30T08:39:29.467469+00:00.