1
0
mirror of https://github.com/simple-icons/simple-icons.git synced 2024-12-16 01:10:30 +02:00
SVG icons for popular brands
Go to file
2023-11-24 21:18:27 +00:00
_data Add Dreamstime (#9716) 2023-11-24 21:18:27 +00:00
.github Fix autocloser workflow (#9848) 2023-11-12 22:37:10 +01:00
.husky Use git add -u in pre-commit hook and fix assign-to-project GHA workflow (#9817) 2023-11-06 09:11:50 +00:00
icons Add Dreamstime (#9716) 2023-11-24 21:18:27 +00:00
scripts Use permanent README icons links in releases (#9788) 2023-10-28 19:24:55 +01:00
tests Add documentation links checking to CI (#9244) 2023-08-10 17:25:53 +02:00
.dockerignore Expose SDK in NPM package (#8077) 2023-04-19 15:23:13 +02:00
.editorconfig
.gitattributes
.gitignore Ignore editor configuration files (#8720) 2023-06-05 00:29:32 +02:00
.jsonschema.json Add sqlalchemy (#9690) 2023-10-21 04:21:36 +02:00
.npmignore Expose SDK in NPM package (#8077) 2023-04-19 15:23:13 +02:00
.npmrc Use save-exact for dependencies (#9846) 2023-11-12 18:34:50 +01:00
.prettierignore Format PR template with Prettier (#9615) 2023-09-25 08:44:18 +01:00
.prettierrc.json Drop trailingComma setting from Prettier config (#9768) 2023-10-22 00:54:42 +01:00
.svglint-ignored.json Fix linting error and refactor .svglintrc.mjs (#9195) 2023-08-04 03:27:20 +02:00
.svglintrc.mjs Fix typo in SVG linting error message (#9769) 2023-10-22 00:52:40 +01:00
CODE_OF_CONDUCT.md Add code of conduct (#9292) 2023-09-01 16:37:14 +02:00
composer.json
CONTRIBUTING.md Add Microchip to excluded brands (#9376) 2023-08-22 18:29:41 +01:00
DISCLAIMER.md Fix GitHub built-in highlight styles (#9241) 2023-08-09 04:23:17 +02:00
Dockerfile Update all dependencies (#8558) 2023-04-28 00:31:21 +02:00
LICENSE.md Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
package.json version bump 2023-11-19 00:25:42 +00:00
README.md Add licenses and versions to third-party plugins (#9911) 2023-11-24 21:16:23 +00:00
sdk.d.ts Refactor tests and scripts (#9237) 2023-08-08 06:38:52 +02:00
sdk.mjs Update all dependencies (#9697) 2023-10-13 01:28:34 +02:00
slugs.md version bump 2023-11-19 00:25:42 +00:00
svgo.config.mjs Modernize SVGO setup (#8149) 2022-12-21 12:56:09 +01:00
types.d.ts Omit undefined properties (#8582) 2023-05-25 14:45:12 +02:00
VERSIONING.md

Simple Icons

Simple Icons

Over 2700 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
Number of icons currently in the library Number of users active in our Discord server Backers and sponsors on Open Collective

Usage

Note


We ask that all users read our legal disclaimer before using icons from Simple Icons.

General Usage

Icons can be downloaded as SVGs directly from our website - simply click the download button of the icon you want, and the download will 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@v9/icons/[ICON SLUG].svg" />
<img height="32" width="32" src="https://unpkg.com/simple-icons@v9/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@v9/icons/simpleicons.svg" />
<img height="32" width="32" src="https://unpkg.com/simple-icons@v9/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.

CDN with colors

We also provide a CDN service which allows you to use colors.

<img height="32" width="32" src="https://cdn.simpleicons.org/[ICON SLUG]" />
<img height="32" width="32" src="https://cdn.simpleicons.org/[ICON SLUG]/[COLOR]" />
<img height="32" width="32" src="https://cdn.simpleicons.org/[ICON SLUG]/[COLOR]/[DARK_MODE_COLOR]" />

Where [COLOR] is optional, and can be replaced by the hex colors or CSS keywords of the icon you want to you use. The color is defaulted to the HEX color of the icon shown in simpleicons.org website. [DARK_MODE_COLOR] is used for dark mode. The CSS prefers-color-scheme will be used when a value is specified. For example:

<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/gray" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/hotpink" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/0cf" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/0cf9" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/00ccff" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/00ccff99" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/orange/pink" />
<img height="32" width="32" src="https://cdn.simpleicons.org/simpleicons/_/eee" />

Node Usage Node

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

npm install simple-icons

All icons are imported from a single file, where [ICON SLUG] is replaced by a capitalized slug. We highly recommend using a bundler that can tree shake such as webpack to remove the unused icon code:

// Import a specific icon by its slug as:
// import { si[ICON SLUG] } from 'simple-icons'

// For example:
// use import/esm to allow tree shaking
import { siSimpleicons } from 'simple-icons';
// or with require/cjs
const { siSimpleicons } = require('simple-icons');

It will return an icon object:

console.log(siSimpleicons);

/*
{
    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 for the icon.
NOTE: the `license` entry will be `undefined` if we do not yet have license data for the icon.
*/

If you need to iterate over all icons, use:

import * as icons from 'simple-icons';

TypeScript Usage Typescript

Type definitions are bundled with the package.

import type { SimpleIcon } from 'simple-icons';

PHP Usage Php

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

Extension Author License Simple Icons Version
Angular module Angular @avmaisak v6.18.0
Blazor Nuget package Blazor @TimeWarpEngineering v9.9.0
Blender add-on Blender @mondeja Latest
Drawio library Drawio @mondeja Latest
Drupal module Drupal Phil Wolstenholme v3.13.0
Figma plugin Figma @LitoMore Latest
Flutter package Flutter @jlnrrg v7.10.0
Framer component Framer @LitoMore Latest
Hexo plugin Hexo @nidbCN v4.25.0
Home Assistant plugin Home Assistant @vigonotion v7.14.0
Hugo module Hugo @foo-dogsquared Latest
Java library OpenJDK @silentsoft v6.16.0
Jetpack Compose library Jetpack Compose @DevSrSouza v4.14.0
Kirby plugin Kirby @runxel v2.19.0
LaTeX package LaTeX @ineshbose Latest
Laravel package Laravel @adrian-ub Latest
Leptos crate Leptos @Carlosted v9.14.0
Python package Python @sachinraja v7.21.0
React package React @wootsbot v9.16.1
Ruby gem Ruby @thepew Latest
Solid package Solid @x64Bits v9.0.0
Stream Deck icon pack Stream Deck @mackenly v7.17.0
Svelte package Svelte @wootsbot v9.19.0
Vue 3 package Vue @wyatt-herkamp v9.10.0
Vue package Vue @noahlitvin v4.7.0
WordPress plugin WordPress @tjtaylo v4.25.0

Note for Extension Authors
From our next major release (v11, releasing on May 26, 2024), we will begin removing third-party extensions from the above list that are not up to date with at least our previous major release.
For example, when v11 is released, we will remove any extensions that don't support v10.0.0 or higher.
Please create a PR to update the version number of your extension in this README following each update of your extension.

Contribute

Good first issues open

Information describing how to contribute can be found in the file CONTRIBUTING.md