Simple Icons

Simple Icons

Over 1000 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.

## Usage ### General Usage Icons can be downloaded as SVGs directly from [our website](https://simpleicons.org/) - simply click the icon you want, and the download should start automatically. ### CDN Usage Icons can be served from a CDN such as [JSDelivr](https://www.jsdelivr.com/package/npm/simple-icons) or [Unpkg](https://unpkg.com/browse/simple-icons/). Simply use the `simple-icons` npm package and specify a version in the URL like the following: ```html ``` Where `[ICON NAME]` is replaced by the icon name, for example: ```html ``` 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: ```javascript const simpleIcons = require('simple-icons'); console.log(simpleIcons.get('Simple Icons')); /* { title: 'Simple Icons', slug: 'simpleicons', hex: '111111', source: 'https://simpleicons.org/', 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](https://webpack.js.org/) and therefore have to be mindful of your package size: ```javascript const icon = require('simple-icons/icons/simpleicons'); console.log(icon); /* { title: 'Simple Icons', slug: 'simpleicons', hex: '111111', source: 'https://simpleicons.org/', svg: '...', path: 'M12 12v-1.5c-2.484 ...' } */ ``` #### 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 ... ?> ``` ## Third Party Extensions ### WordPress Icons are also available on WordPress through a simple plugin created by [@tjtaylo](https://github.com/tjtaylo), which you can find [here](https://wordpress.org/plugins/simple-icons/). ### Drupal Icons are also availabe on Drupal through a module created by [Phil Wolstenholme](https://www.drupal.org/u/phil-wolstenholme), which you can find [here](https://www.drupal.org/project/simple_icons). ### Kirby Icons are also available on Kirby through a simple plugin created by [@runxel](https://github.com/runxel), which you can find [here](https://github.com/runxel/kirby3-simpleicons). ### React Icons are also available on React through a simple package created by [@wootsbot](https://github.com/wootsbot), which you can find [here](https://github.com/icons-pack/react-simple-icons). ### Svelte Icons are also available on Svelte through a simple package created by [@wootsbot](https://github.com/wootsbot), which you can find [here](https://github.com/icons-pack/svelte-simple-icons). ## Status [![Build Status](https://travis-ci.com/simple-icons/simple-icons.svg?branch=develop)](https://travis-ci.com/simple-icons/simple-icons) [![npm version](https://img.shields.io/npm/v/simple-icons.svg)](https://www.npmjs.com/package/simple-icons) [![Packagist version](https://img.shields.io/packagist/v/simple-icons/simple-icons)](https://packagist.org/packages/simple-icons/simple-icons)