npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@nimiq/identicons

v1.6.2

Published

Nimiq Identicons

Downloads

1,473

Readme

Nimiq Identicons

Nimiq Identicons Example 1

SVG+JS Identicons designed to run in browsers and NodeJS. The library is heavily optimized for performance.

See the Identicons in action here.

Installation

Nimiq Identicons can be used in both browsers and NodeJS:

Browsers

You can either use the Identicons script already bundled with the image data (default), or with an external SVG file which is loaded separately.

The Identicons script is provided as an ES6 module and needs to be imported into module scripts or used with build systems such as Webpack and Rollup:

  1. npm install --save @nimiq/identicons or yarn add @nimiq/identicons
  2. import Identicons from '@nimiq/identicons'
  3. See how to use it under Usage

To use the other version of the library, which loads the image data separately, you have to import Identicons from '@nimiq/identicons/dist/identicons.min.js' instead. Additionally you have to make sure that the identicons.min.svg file included in the dist directory of this package is made available to website visitors. Then specify the path where the library can find this SVG file, either by setting Identicons.svgPath = '/public/path/to/identicons.min.svg' or in the global scope with window.NIMIQ_IDENTICONS_SVG_PATH = '/public/path/to/identicons.min.svg'.

Note: Besides installing the package yourself, you can also use a npm-enabled CDN: import Identicons from https://unpkg.com/@nimiq/[email protected]/dist/identicons.bundle.min.js.

NodeJS

For NodeJS a CommonJS module is provided, which can simply be installed and used by doing:

  1. npm install --save @nimiq/identicons or yarn add @nimiq/identicons
  2. const Identicons = require('@nimiq/identicons').default (the .default is important!)
  3. See how to use it under Usage

If you are using a version of NodeJS with import enabled, or are using an ES6 loader such as esm or babel-register, you can just do import Identicons from '@nimiq/identicons' for step 2.

Usage

All methods generating identicons are async and return promises.

Get a raw SVG text string:

    const svg = await Identicons.svg(text)

Get a SVG data url string (the one starting with data:image/svg+xml;base64,...), which can be set as img.src:

    const dataUrl = await Identicons.toDataUrl(text)

Render an identicon SVG into the DOM (only in browsers!):

    await Identicons.render(text, element)

Get an <img> DOM node (only in browsers!):

    const img = await Identicons.image(text)

You can generate a placeholder icon with these (sync) methods:

    // Placeholder SVG:
    const svg = Identicons.placeholder(color = '#bbb', strokeWidth = 1)
    // Placeholder data url:
    const dataUrl = Identicons.placeholderToDataUrl(color = '#bbb', strokeWidth = 1)
    // Render placeholder SVG into `element`:
    Identicons.renderPlaceholder(element, color = '#bbb', strokeWidth = 1)

Demos

Background Info

For more information on our design decisions read our design blog post or watch the Vlog about the beginning of the Identicons.


This is an open source contribution by Nimiq - the browser-based blockchain.

Nimiq Identicons Example 2