1
0
mirror of https://github.com/simple-icons/simple-icons.git synced 2024-12-26 01:13:41 +02:00
SVG icons for popular brands
Go to file
Eric Cornelissen ce27500858
Update Node Usage section in README (#4950)
Update the examples in the "Node Usage" section of the README to clarify
where you need to specify the brand you're interested in. The approach
follows the style of the "CDN Usage" section of the README.
2021-02-08 15:03:12 +00:00
_data Add dwm (#4891) 2021-02-03 09:41:33 +00:00
.github Revert 008d289f69 2021-01-26 14:37:54 +01:00
icons Add dwm (#4891) 2021-02-03 09:41:33 +00:00
images Update Simple Icons icon (#3137) 2020-06-30 00:12:11 +03:00
scripts Add more characters to normalisation scripts (#4833) 2021-02-03 00:06:49 +01:00
tests Allow exponential notation with E uppercase inside icon paths (#3843) 2020-11-18 18:57:25 +01:00
_config.yml Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
.dockerignore Update Dockerfile (#4271) 2020-12-04 17:14:17 +01:00
.editorconfig Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
.gitattributes Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
.gitignore Ignore files that are not SVGs in the icons folder (#4672) 2021-01-08 09:33:40 +00:00
.gitpod.yml Add Gitpod icon. (#1579) 2019-08-06 18:52:52 +03:00
.jsonlintschema Keep track of brand guidelines/presskits/etc. explicitly (#2846) 2021-01-17 21:41:03 +00:00
.npmignore Add index.js to .npmignore whitelist 2017-09-17 03:49:13 +02:00
.svglint-ignored.json Updated Google News (#4474) 2021-01-29 15:04:02 +00:00
.svglintrc.js Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
.svgo.yml Remove fill-rule 2020-03-23 15:00:34 +01:00
CNAME Update CNAME 2015-11-02 14:20:14 +00:00
composer.json Add composer.json (#1611) 2019-09-26 09:04:33 +03:00
CONTRIBUTING.md Keep track of brand guidelines/presskits/etc. explicitly (#2846) 2021-01-17 21:41:03 +00:00
Dockerfile Update Dockerfile (#4271) 2020-12-04 17:14:17 +01:00
Gemfile Formalize website Ruby dependencies and installation process (#4416) 2020-12-22 21:11:57 +01:00
Gemfile.lock Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
index.html Website: add banner asking visitors to check out the redesign (#4872) 2021-02-04 16:29:09 +00:00
LICENSE.md Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
package-lock.json Update dependency uglify-js to v3.12.7 (#4948) 2021-02-08 12:08:38 +01:00
package.json Update dependency uglify-js to v3.12.7 (#4948) 2021-02-08 12:08:38 +01:00
README.md Update Node Usage section in README (#4950) 2021-02-08 15:03:12 +00:00
site_script.js Website: add banner asking visitors to check out the redesign (#4872) 2021-02-04 16:29:09 +00:00
stylesheet.css Website: add banner asking visitors to check out the redesign (#4872) 2021-02-04 16:29:09 +00:00

Simple Icons

Simple Icons

Over 1500 Free SVG icons for popular brands. See them all on one page at SimpleIcons.org. Contributions, corrections & requests can be made on GitHub. Started by Dan Leech.

Build status NPM version Build status

Usage

General Usage

Icons can be downloaded as SVGs directly from our website - simply click the icon you want, and the download should start automatically.

CDN Usage

Icons can be served from a CDN such as JSDelivr or Unpkg. Simply use the simple-icons npm package and specify a version in the URL like the following:

<img height="32" width="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/[ICON NAME].svg" />
<img height="32" width="32" src="https://unpkg.com/simple-icons@v4/icons/[ICON NAME].svg" />

Where [ICON NAME] is replaced by the icon name, for example:

<img height="32" width="32" src="https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/simpleicons.svg" />
<img height="32" width="32" src="https://unpkg.com/simple-icons@v4/icons/simpleicons.svg" />

These examples use the latest major version. This means you won't receive any updates following the next major release. You can use @latest instead to receive updates indefinitely. However, this will result in a 404 error if the icon is removed.

Node Usage

The icons are also available through our npm package. To install, simply run:

$ npm install simple-icons

The API can then be used as follows:

const simpleIcons = require('simple-icons');

// Get a specific icon by its name as:
simpleIcons.get('[ICON NAME]');

// For example:
const icon = simpleIcons.get('simpleicons');

console.log(icon);

/*
{
    title: 'Simple Icons',
    slug: 'simpleicons',
    hex: '111111',
    source: 'https://simpleicons.org/',
    svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">...</svg>',
    path: 'M12 12v-1.5c-2.484 ...'
}
*/

Alternatively you can import the needed icons individually. This is useful if you are e.g. compiling your code with webpack and therefore have to be mindful of your package size:

// Import a specific icon by its name as:
require('simple-icons/icons/[ICON NAME]');

// For example:
const icon = require('simple-icons/icons/simpleicons');

console.log(icon);

/*
{
    title: 'Simple Icons',
    slug: 'simpleicons',
    hex: '111111',
    source: 'https://simpleicons.org/',
    svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">...</svg>',
    path: 'M12 12v-1.5c-2.484 ...'
}
*/

Lastly, the simpleIcons object is also enumerable. This is useful if you want to do a computation on every icon:

const simpleIcons = require('simple-icons');

for (const title in simpleIcons) {
    const icon = simpleIcons.get(title);
    // do stuff
}

TypeScript Usage

There are also TypeScript type definitions for the Node package. To use them, simply run:

$ npm install @types/simple-icons

PHP Usage

The icons are also available through our Packagist package. To install, simply run:

$ composer require simple-icons/simple-icons

The package can then be used as follows:

<?php

echo file_get_contents('path/to/package/icons/simple-icons.svg');

// <svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">...</svg>
?>

Third Party Extensions

Drupal

Icons are also available as a Drupal module created by Phil Wolstenholme.

Flutter

Icons are also available as a Flutter package created by @jlnrrg.

Home Assistant

Icons are also available as a Home Assistant plugin created by @vigonotion.

Kirby

Icons are also available as a Kirby plugin created by @runxel.

React

Icons are also available as a React package created by @wootsbot.

Svelte

Icons are also available as a Svelte package created by @wootsbot.

Vue

Icons are also available as a Vue package created by @noahlitvin.

WordPress

Icons are also available as a WordPress plugin created by @tjtaylo.