1
0
mirror of https://github.com/simple-icons/simple-icons.git synced 2024-11-26 01:00:27 +02:00
SVG icons for popular brands
Go to file
2021-04-14 12:05:13 +01:00
_data Update Loom (#5378) 2021-04-14 12:05:13 +01:00
.github Update Preview Generator URL in PR Template (#5430) 2021-04-11 12:14:55 +02:00
icons Update Loom (#5378) 2021-04-14 12:05:13 +01:00
images Update Simple Icons icon (#3137) 2020-06-30 00:12:11 +03:00
scripts Add guidelines data to NPM package and documenation (#5342) 2021-03-26 09:33:04 +00:00
tests Update NPM test suite (#5370) 2021-04-06 16:53:46 +02: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 Document slugs of brands (#5002) 2021-03-03 10:57:33 +00: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
.jsonschema.json Update 'C' icons. (#5273) 2021-03-15 17:21:43 +00:00
.npmignore Add index.js to .npmignore whitelist 2017-09-17 03:49:13 +02:00
.svglint-ignored.json Update pre-commit icon (#5226) 2021-03-13 22:39:25 +01:00
.svglintrc.js Update Elsevier; fix edge case error in 'collinear segments' lint rule (#5175) 2021-03-10 17:52:08 +00: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 Add Slugs to Contributing Guidelines (#5150) 2021-03-04 12:58:23 +01: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 Bump kramdown from 2.3.0 to 2.3.1 (#5382) 2021-04-02 10:57:05 +02:00
index.html Remove project founder's explicit association with the project 2021-04-02 11:01:51 +02:00
LICENSE.md Minor improvements (#4708) 2021-01-15 21:47:00 +01:00
package-lock.json version bump 2021-04-11 00:24:29 +00:00
package.json version bump 2021-04-11 00:24:29 +00:00
README.md Remove project founder's explicit association with the project 2021-04-02 11:01:51 +02:00
site_script.js Website: add banner asking visitors to check out the redesign (#4872) 2021-02-04 16:29:09 +00:00
slugs.md version bump 2021-04-11 00:24:29 +00:00
stylesheet.css Website: add banner asking visitors to check out the redesign (#4872) 2021-02-04 16:29:09 +00:00
svgo.config.js Upgrade SVGO to version 2 (#5079) 2021-02-21 13:48:30 +01: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.

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 SLUG].svg" />
<img height="32" width="32" src="https://unpkg.com/simple-icons@v4/icons/[ICON SLUG].svg" />

Where [ICON SLUG] is replaced by the slug of the icon you want to use, 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, where [ICON SLUG] is replaced by a slug:

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

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

// 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 ...',
    guidelines: 'https://simpleicons.org/styleguide',
    license: {
        type: '...',
        url: 'https://example.com/'
    }
}

NOTE: the `guidelines` entry will be `undefined` if we do not yet have guidelines data for the icon.
NOTE: the `license` entry will be `undefined` if we do not yet have license data for the icon.
*/

Alternatively you can import the needed icons individually, where [ICON SLUG] is replaced by a slug. 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 slug as:
require('simple-icons/icons/[ICON SLUG]');

// 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 ...',
    guidelines: 'https://simpleicons.org/styleguide',
    license: {
        type: '...',
        url: 'https://example.com/'
    }
}

NOTE: the `guidelines` entry will be `undefined` if we do not yet have guidelines data for the icon.
NOTE: the license may be `undefined` if there is no license data for the icon.
*/

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, where [ICON SLUG] is replaced by a slug:

<?php
// Import a specific icon by its slug as:
echo file_get_contents('path/to/package/icons/[ICON SLUG].svg');

// For example:
echo file_get_contents('path/to/package/icons/simpleicons.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.

Jetpack Compose

Icons are also available as a Jetpack Compose library created by @devsrsouza.

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.