Icons Gallery - Self-hosted Icons CDN Accelerated Service

Project Links#

• Online Gallery: ico.bytecook.io
• NPM Package: @bytecook/icons
• Upstream Repository: github.com/selfhst/icons
• Official Package: jsdelivr.com/package/gh/selfhst/icons

Why This Project#

selfh.st/icons is a high-quality collection of self-hosted application icons, featuring 6000+ curated icons covering a wide range of common self-hosted services and applications. It is suitable for:

• Dashboards like Homepage / Homarr / Dashy
• NAS / Server application displays
• Icon references in documentation and blogs

However, since the original resources are mainly hosted on GitHub, users in mainland China often encounter the following issues:

• Slow access speeds
• Failed icon loading
• Unstable jsDelivr CDN

To address these problems, this CDN accelerated mirror service was created.

Speed Comparison#

Features#

• 6000+ icons, fully synced with selfh.st/icons repository
• Support for SVG / PNG / WebP / AVIF / ICO formats
• China CDN acceleration for fast and stable access
• Online browsing, search, and category filtering
• One-click copy of icon direct links
• Light / Dark theme switching support

Usage#

1
https://ico.bytecook.io/{format}/{icon-name}.{format}

1
npm install @bytecook/icons
2
# or
3
pnpm add @bytecook/icons
4
# or
5
yarn add @bytecook/icons

1
import { createIconUrl } from '@bytecook/icons';
2

3
// Default: SVG format, Peekabo CDN (China accelerated)
4
createIconUrl('nginx');
5
// => https://ico.bytecook.io/svg/nginx.svg
6

7
// Specify format
8
createIconUrl('nginx', { format: 'png' });
9
// => https://ico.bytecook.io/png/nginx.png
10

11
// Dark/Light variants
12
createIconUrl('nginx', { format: 'png', variant: 'dark' });
13
// => https://ico.bytecook.io/png/nginx-dark.png
14

15
// Use jsDelivr CDN (global)
16
createIconUrl('nginx', { cdn: 'jsdelivr' });
17
// => https://cdn.jsdelivr.net/gh/selfhst/icons@main/svg/nginx.svg

1
import { createIconHelper } from '@bytecook/icons';
2

3
const icons = createIconHelper({ format: 'webp' });
4

5
icons.url('docker');           // WebP format
6
icons.svg('docker');           // Force SVG
7
icons.png('docker', 'dark');   // PNG dark variant

1
import iconList from '@bytecook/icons/icons.json';
2

3
console.log(iconList.length); // 2360+ icons
4

5
// Each icon contains:
6
// { name, reference, category, svg, png, webp, light, dark, tags }

CDN Endpoints#

Supported Formats#

• SVG - Scalable vector graphics (recommended)
• PNG - Raster images
• WebP - Modern format with good compression
• AVIF - Next-gen format with best compression
• ICO - Windows icon format

Icon Variants#

Many icons support light and dark variants:

• Standard: nginx.svg
• Light variant: nginx-light.svg
• Dark variant: nginx-dark.svg

Related Links#

• Online Gallery: ico.bytecook.io
• NPM Package: @bytecook/icons
• Official Package: jsdelivr.com/package/gh/selfhst/icons
• Icon Source: selfh.st/icons
• CDN Sponsor: Peekabo CDN