1
0
mirror of https://github.com/simple-icons/simple-icons.git synced 2024-11-16 00:59:07 +02:00
SVG icons for popular brands
Go to file
Álvaro Mondéjar 3ee620b9d6
Forbid the usage of non secure URLs (#7855)
* Forbid the usage of non secure URLs

* Document in CONTRIBUTING

* Add test to forbid HTTP URLs in documentation pages
2022-09-24 17:37:03 +02:00
_data Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
.github Update all dependencies (#7442) 2022-05-26 11:38:46 +02:00
.husky fix: make .husky/pre-commit executable (#6787) 2021-10-28 16:29:05 -07:00
assets/readme Add Figma plugin (#7764) 2022-09-15 07:03:34 +08:00
icons Update Douban icon (#7843) 2022-09-21 23:57:07 +08:00
scripts Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
tests Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
.dockerignore remove icons/* entrypoints (#6788) 2022-05-26 14:29:37 +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 feat: add Marko icon (#7386) 2022-05-07 11:11:20 -07:00
.jsonschema.json Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
.npmignore remove icons/* entrypoints (#6788) 2022-05-26 14:29:37 +02:00
.npmrc Drop package-lock.json (#6179) 2021-08-23 19:21:03 +02:00
.prettierignore remove icons/* entrypoints (#6788) 2022-05-26 14:29:37 +02:00
.prettierrc.json Convert prettierrc.js file to JSON (#7424) 2022-05-17 05:36:28 -07:00
.svglint-ignored.json Update Cocos icon (#6996) 2022-01-03 15:39:50 +00:00
.svglintrc.mjs Standarize locale comparisons and sort icons by title in package (#7854) 2022-09-24 17:29:43 +02:00
composer.json Add links to composer.json (#7382) 2022-05-05 14:56:14 -07:00
CONTRIBUTING.md Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
DISCLAIMER.md Replace note emoji with proper note markdown (#7632) 2022-08-01 17:54:09 -07:00
Dockerfile Update all dependencies (#7397) 2022-05-09 13:17:22 +02:00
index.d.ts deprecate index (#7453) 2022-05-26 23:18:44 -07:00
LICENSE.md Forbid the usage of non secure URLs (#7855) 2022-09-24 17:37:03 +02:00
package.json version bump 2022-09-18 00:30:22 +00:00
README.md Add Figma plugin (#7764) 2022-09-15 07:03:34 +08:00
slugs.md version bump 2022-09-18 00:30:22 +00:00
svgo.config.js Update SVGO configuration (#6926) 2021-11-29 09:59:11 -08:00
VERSIONING.md Create VERSIONING.md (#6023) 2021-09-30 09:33:44 +02:00

Simple IconsSimple Icons

Simple Icons

Over 2300 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 Backers and sponsors on Open Collective

Usage

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

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/icons'

// For example:
// use import/esm to allow tree shaking
import { siSimpleicons } from 'simple-icons/icons';
// or with require/cjs
const { siSimpleicons } = require('simple-icons/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.
*/

TypeScript Usage TypescriptTypescript

Type definitions are bundled with the package.

PHP Usage PhpPhp

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
AngularAngular Angular Module @avmaisak
BlazorBlazor Blazor Nuget @TimeWarpEngineering
BlenderBlender Blender add-on @mondeja
DrawioDrawio Drawio library @mondeja
DrupalDrupal Drupal module Phil Wolstenholme
FigmaFigma Figma plugin @LitoMore
FlutterFlutter Flutter package @jlnrrg
HexoHexo Hexo plugin @nidbCN
Home AssistantHome Assistant Home Assistant plugin @vigonotion
HugoHugo Hugo module @foo-dogsquared
OpenJDKOpenJDK Java library @silentsoft
Jetpack ComposeJetpack Compose Jetpack Compose library @devsrsouza
KirbyKirby Kirby plugin @runxel
LaTeXLaTeX LaTeX package @ineshbose
LaravelLaravel Laravel Package @adrian-ub
PythonPython Python package @sachinraja
ReactReact React package @wootsbot
Simple IconsSimple Icons Stream Deck icon pack @mackenly
SvelteSvelte Svelte package @wootsbot
VueVue Vue 3 package @wyatt-herkamp
VueVue Vue package @noahlitvin
WordpressWordpress WordPress plugin @tjtaylo

Contribute

Good first issues open

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