Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LitoMore/simple-icons-cdn
Colorable Simple Icons CDN
https://github.com/LitoMore/simple-icons-cdn
badgen brands cdn colors icons logos notion simple-icons simple-icons-cdn simpleicons svg
Last synced: 3 months ago
JSON representation
Colorable Simple Icons CDN
- Host: GitHub
- URL: https://github.com/LitoMore/simple-icons-cdn
- Owner: LitoMore
- License: mit
- Created: 2022-09-28T11:57:31.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-28T05:40:50.000Z (3 months ago)
- Last Synced: 2024-07-28T06:38:16.197Z (3 months ago)
- Topics: badgen, brands, cdn, colors, icons, logos, notion, simple-icons, simple-icons-cdn, simpleicons, svg
- Language: JavaScript
- Homepage: https://cdn.simpleicons.org
- Size: 356 KB
- Stars: 82
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-notion - Simple Icons CDN - The CDN service of the free brand icons set for your Notion pages. (Tools)
README
simple-icons-cdn
## Disclaimer
We ask that all users read the [legal disclaimer](https://github.com/simple-icons/simple-icons/blob/develop/DISCLAIMER.md) 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](https://simpleicons.org) to copy the slug.
All icon slugs can be found at [slugs.md](https://github.com/simple-icons/simple-icons/blob/master/slugs.md).
#### `color`
Optional. Default to the color of icon from [simpleicons.org](https://simpleicons.org). It supports [hex colors](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color) and [CSS keywords](https://www.w3.org/wiki/CSS/Properties/color/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](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/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.
### Examples
- 
- https://cdn.simpleicons.org/simpleicons
- 
- https://cdn.simpleicons.org/simpleicons/blue
- 
- https://cdn.simpleicons.org/simpleicons/hotpink
- 
- https://cdn.simpleicons.org/simpleicons/0cf
- 
- https://cdn.simpleicons.org/simpleicons/0cf9
- 
- https://cdn.simpleicons.org/simpleicons/00ccff
- 
- https://cdn.simpleicons.org/simpleicons/00ccff99
- 
- https://cdn.simpleicons.org/simpleicons/orange/pink
- 
- https://cdn.simpleicons.org/simpleicons/_/eee
- 
- [https://cdn.simpleicons.org/simpleicons/eee/\_](https://cdn.simpleicons.org/simpleicons/eee/_)
#### Auto-sized
This is useful if you want all icons rendered with consitent size.
```markdown
```
### Other usages
#### Raycast
Easily browse, search, and copy icon SVG source, brand color, guidelines, and CDN links with Raycast.
#### Notion
You can use this icon CDN anywhere in Notion which allows you to insert a custom image or icon.
### Domain aliases
- [cdn.simpleicons.org](https://cdn.simpleicons.org/simpleicons)
- [icons.ly](https://icons.ly/simpleicons)
## License
MIT