Skip to content

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

License

Notifications You must be signed in to change notification settings

dmester/jdenticon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c894f54 · May 10, 2024
May 10, 2024
Jul 30, 2020
Aug 7, 2022
Dec 12, 2020
May 10, 2024
Aug 7, 2022
May 10, 2024
Jul 30, 2020
May 10, 2024
Aug 14, 2021
Jul 30, 2020
Dec 12, 2020
Jul 31, 2020
May 10, 2024
May 10, 2024
Jul 13, 2019
Aug 7, 2022
May 10, 2024
May 10, 2024

Repository files navigation

JavaScript library for generating highly recognizable identicons using HTML5 canvas or SVG.

Sample identicons

Tests Downloads jsDelivr npm bundle size License MIT

Live demo

https://jdenticon.com

Getting started

Using Jdenticon is simple. Follow the steps below to integrate Jdenticon into your website.

1. Add identicon placeholders

Jdenticon is able to render both raster and vector identicons. Raster icons are rendered slightly faster than vector icons, but vector icons scale better on high resolution screens. Add a canvas to render a raster icon, or an inline svg element to render a vector icon.

<!-- Vector icon -->
<svg width="80" height="80" data-jdenticon-value="icon value"></svg>

<!-- OR -->

<!-- Raster icon -->
<canvas width="80" height="80" data-jdenticon-value="icon value"></canvas>

2. Add reference to Jdenticon

Include the Jdenticon library somewhere on your page. You can either host it yourself or use it right off jsDelivr.

<!-- Using jsDelivr -->
<script src="https://cdn.jsdelivr.net/npm/jdenticon@3.3.0/dist/jdenticon.min.js"
        integrity="sha384-LfouGM03m83ArVtne1JPk926e3SGD0Tz8XHtW2OKGsgeBU/UfR0Fa8eX+UlwSSAZ"
        crossorigin="anonymous">
</script>

<!-- OR -->

<!-- Hosting it yourself -->
<script src="-path-to-/jdenticon.min.js"></script>

That's it!

Other resources

API documentation

For more usage examples and API documentation, please see:

https://jdenticon.com

Other platforms

There are ports or bindings for Jdenticon available for the following platforms:

License

Jdenticon is available under the MIT license.