Skip to content
This repository has been archived by the owner on Oct 25, 2023. It is now read-only.

wpmudev/sui-icons

Repository files navigation

npm License: GPLv2

Shared UI Icons Pack

Install

This repository is distributed with npm. After installing npm, you can install @wpmudev/sui-icons with this command.

npm i --save-dev @wpmudev/sui-icons

Usage

There are many ways/formats to use the Shared UI Icons Package. The fastest and recommended way is via SVG directly. Or use the Webfont version if you want to include all icons at once:

SVG Icons - For a few icons in your project

  1. Suppose you want to use just a few icons. Find the icons you need in the "icons" folder. Then use them as regular images:
<img
	width="32"
	height="32"
	src="@wpmudev/sui-icons/dist/svg/plugin-smartcrawl.svg"
	alt="SmartCrawl Plugin" />
  1. It's possible to serve the icons from a CDN such as Unpkg. Use the @wpmudev/sui-icons npm package in the URL like the following:
<img
	width="32"
	height="32"
	src="https://unpkg.com/@wpmudev/sui-icons/dist/svg/plugin-smartcrawl.svg"
	alt="SmartCrawl Plugin" />

Icons Font - Ideal when you want to include all icons at once

  1. Install the @wpmudev/sui-icons and in the &lt;head&gt; of your HTML file, reference the location to your sui-icons.css stylesheet.
<head>
  ...
  <link rel="stylesheet" href="@wpmudev/sui-icons/dist/css/sui-icons.css" />
  ...
</head>
  1. Use unpkg.com to load the Shared UI Icons Pack directly without installing anything:
<head>
  ...
  <link rel="stylesheet" href="https://unpkg.com/@wpmudev/sui-icons/dist/css/sui-icons.css" />
  ...
</head>

Place the suicons class with &lt;span&gt; tag in your HTML file, like this. Then, use the icon name along with the suicons- class prefix.

<span class="suicons suicons--plugin-smartcrawl"></span>

Bugs, Ideas, Pull Requests

If you have any ideas or found bugs, please send me Pull Requests or let me know with GitHub Issues.

License

Can I use the SUI Icons Pack in my projects?

We created the WPMU DEV Design System to build plugins and products for WPMU DEV, not on products outside the company. Please visit the terms of use for full license details.

Need a new icon?

New icons need to be added to SUI Icons Pack first. Please, visit the Support page for more information on how to request it.

We can usually add an icon and release a new version on the same day if there is a hurry. However, remember that if there's a similar icon already available, we suggest you use it instead unless you request a design update.