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
2024-05-22 08:42:12 +01:00
_data Add Homepage icon (#10452) 2024-05-22 08:42:12 +01:00
.github Update Issue Template (#10642) 2024-05-18 16:06:31 +01:00
.husky Migrate Husky to v9 (#10403) 2024-02-06 17:47:53 +01:00
icons Add Homepage icon (#10452) 2024-05-22 08:42:12 +01:00
scripts Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
tests Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
.dockerignore Expose SDK in NPM package (#8077) 2023-04-19 15:23:13 +02:00
.editorconfig Remove (old) website source files (#5553) 2021-05-29 18:00:40 +02:00
.gitattributes Drop package-lock.json (#6179) 2021-08-23 19:21:03 +02:00
.gitignore Ignore editor configuration files (#8720) 2023-06-05 00:29:32 +02:00
.jsonschema.json Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
.npmignore Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
.npmrc Update all dependencies (#10882) 2024-05-03 00:15:20 +02:00
.prettierignore Add XO linter (#10643) 2024-03-24 18:38:18 +01:00
.prettierrc.json Add XO linter (#10643) 2024-03-24 18:38:18 +01:00
.svglint-ignored.json Fix collinear segment on Hepsiemlak (#10619) 2024-03-13 08:10:03 +08:00
.xo-config.json Update XO configurations (#10859) 2024-05-02 22:54:43 +02:00
CODE_OF_CONDUCT.md Add code of conduct (#9292) 2023-09-01 16:37:14 +02:00
composer.json Add links to composer.json (#7382) 2022-05-05 14:56:14 -07:00
CONTRIBUTING.md Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
DISCLAIMER.md Fix issue templates (#10804) 2024-04-12 19:36:54 +02:00
Dockerfile Use Node.js 22 (#10881) 2024-05-02 23:24:43 +02:00
LICENSE.md Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
package.json version bump 2024-05-19 00:26:15 +00:00
README.md Updates to README ahead of v12. (#10977) 2024-05-20 12:25:30 +01:00
sdk.d.ts Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
sdk.mjs Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
slugs.md version bump 2024-05-19 00:26:15 +00:00
svglint.config.mjs Refactor JSONSchema and URL checks (#10276) 2024-05-22 08:13:35 +01:00
svgo.config.mjs Add XO linter (#10643) 2024-03-24 18:38:18 +01:00
types.d.ts Add XO linter (#10643) 2024-03-24 18:38:18 +01:00
VERSIONING.md Update deprecation notice in versioning policy (#10440) 2024-02-27 18:55:25 +01:00

Simple Icons

Simple Icons

Over 3100 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

Important

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

The below are known extensions to third-party tools.

Extension Author
Blender add-on Blender @mondeja
Boxy SVG library Boxy SVG @Jarek
Drawio library Drawio @mondeja
Figma plugin Figma @LitoMore
Miro app Miro @LitoMore
Raycast extension Raycast @LitoMore
Stream Deck icon pack Stream Deck @mackenly
Webflow app Webflow @diegoliv

Maintain an extension? Submit a PR to include it in the list above.

Third-Party Libraries

The below are known third-party libraries for use in your own projects. We only keep items in the list that are at least up to date with our previous major version.

Library Author License Simple Icons Version
Blazor Nuget package Blazor @TimeWarpEngineering
Framer component Framer @LitoMore
Hugo module Hugo @foo-dogsquared
Kirby plugin Kirby @runxel
LaTeX package LaTeX @ineshbose
Laravel package Laravel @adrian-ub
React package React @wootsbot
Ruby gem Ruby @thepew
Svelte package Svelte @wootsbot
Vue 3 package Vue @wyatt-herkamp

Maintain a library? Submit a PR to include it in the list above.

Contribute

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

Contributors