Home

Awesome

<h1 align="center">simple-icons-cdn</h1> <p align="center">Colorable and resizable CDN for Simple Icons</p> <p align="center"> <a href="https://github.com/LitoMore/simple-icons-cdn/actions"> <img src="https://img.shields.io/github/actions/workflow/status/LitoMore/simple-icons-cdn/deno.yml?branch=main&logo=deno&logoColor=000&label=Deno&labelColor=fff"/> </a> <a href="https://fly.io"> <img src="https://img.shields.io/badge/Powered_by_Fly.io-24175B?logo=flydotio&logoColor=fff" /> </a> </p>

Disclaimer

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

Usage

GET https://cdn.simpleicons.org/:icon_slug/:color?/:dark_mode_color?

Parameters

icon_slug

You can simply click the icon title on simpleicons.org to copy the slug.

All icon slugs can be found at slugs.md.

color

Optional. Default to the color of icon from simpleicons.org. It supports hex colors and CSS keywords. Passing in an invalid value will use the default color as a fallback.

dark_mode_color

Optional. It's used for dark mode and has the same function as color. The CSS prefers-color-scheme will be used when a value is specified.

viewbox

Optional. The icon is placed in a square viewBox by default. Use the query parameter viewbox=auto to adjust the viewBox to the same aspect ratio as the shape.

size

Optional. It's used for customizing the icon size. Use the query parameter size to scale with its original aspect ratio.

Examples

Auto-sized

This is useful if you want all icons rendered with consitent size.

<img height="20" src="https://cdn.simpleicons.org/javascript?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/python?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/kotlin?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/dart?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/r?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/swift?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/julia?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/haskell?viewbox=auto" />
<img height="20" src="https://cdn.simpleicons.org/clojure?viewbox=auto" />
<p align="center"> <img height="20" src="https://cdn.simpleicons.org/javascript?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/python?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/kotlin?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/dart?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/r?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/swift?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/julia?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/haskell?viewbox=auto" /> <img height="20" src="https://cdn.simpleicons.org/clojure?viewbox=auto" /> </p>

Other usages

Raycast

Easily browse, search, and copy icon SVG source, brand color, guidelines, and CDN links with Raycast.

<p align="center"> <a title="Install simple-icons Raycast Extension" href="https://www.raycast.com/litomore/simple-icons"> <img src="https://www.raycast.com/litomore/simple-icons/install_button@2x.png?v=1.1" width="256" style="width: 256px;"> </a> </p>

Notion

You can use this icon CDN anywhere in Notion which allows you to insert a custom image or icon.

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/LitoMore/simple-icons-cdn/main/media/notion-screenshot-dark.webp"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/LitoMore/simple-icons-cdn/main/media/notion-screenshot-light.webp"> <img width="400" src="https://raw.githubusercontent.com/LitoMore/simple-icons-cdn/main/media/notion-screenshot-light.webp" /> </picture> </p>

Terminal

It's possible to use icons from the terminal emulator since iTerm2 has special image support.

imgcat -u 'https://cdn.simpleicons.org/go'
imgcat -u 'https://cdn.simpleicons.org/go?viewbox=auto'
imgcat -u 'https://cdn.simpleicons.org/go?viewbox=auto&size=48'
<p align="center"> <img width="465" src="https://raw.githubusercontent.com/LitoMore/simple-icons-cdn/main/media/imgcat-screenshot.webp" /> </p>

Domain aliases

Related

License

MIT