icons-cli

Generate app icons for all platforms from a single source image.

npx icons-cli pwa logo.png

Features

• 26 platforms - iOS, Android, macOS, Windows, PWA, Favicon, plus social media (Twitter/X, Instagram, YouTube, LinkedIn, Facebook, TikTok) and more
• Single source - One image in, all icons out
• Smart defaults - Sensible output directories and filenames
• SDK included - Use programmatically in your build scripts
• Fast - Powered by Sharp for high-performance image processing

Installation

# Use directly with npx
npx icons-cli <provider> <input>

# Or install globally
npm install -g icons-cli

# Or add to your project
npm install icons-cli

CLI Usage

icons <provider> <input> [options]

Providers

Provider	Description
android	Generate Android app icons for Play Store and devices
chrome	Generate Chrome/Chromium extension icons
discord	Generate Discord bot and server icons
electron	Generate Electron app icons for all desktop platforms
facebook	Generate profile, cover, and post images for Facebook
favicon	Generate favicon bundle (ICO + PNG)
firefox	Generate Firefox extension icons
instagram	Generate profile, post, and story images for Instagram
ios	Generate iOS app icons for iPhone and iPad
ipad	Generate iPad app icons for App Store and devices
iphone	Generate iPhone app icons for App Store and devices
linkedin	Generate profile, banner, and post images for LinkedIn
macos	Generate macOS app icons (.icns + appiconset)
og	Generate social media preview images
pwa	Generate complete PWA icon set with manifest
safari	Generate Safari web extension icons
slack	Generate Slack app and bot icons
tauri	Generate Tauri app icons for all platforms
tiktok	Generate profile and video images for TikTok
tvos	Generate Apple TV app icons
twitter	Generate profile and header images for X (Twitter)
vscode	Generate VS Code extension icons
watchos	Generate Apple Watch app icons
web	Generate basic web icons (favicon + apple-touch)
windows	Generate Windows app icons (.ico + tiles)
youtube	Generate channel art, profile, and thumbnail images for YouTube

Options

Option	Description
-o, --output <dir>	Output directory (default: ./<provider>)
-z, --zip	Create zip archive
-q, --quiet	Suppress all output
--dry-run	Preview without writing files
-f, --force	Overwrite existing files

Input Sources

# Local file
icons pwa ./logo.png

# URL
icons pwa https://example.com/logo.png

# Clipboard
icons pwa clipboard

Examples

# Generate PWA icons
icons pwa logo.png

# Generate iOS icons to custom directory
icons ios logo.png -o ./assets/ios

# Generate favicon with zip archive
icons favicon logo.png -z

# Preview what would be generated
icons android logo.png --dry-run

# Generate from URL
icons pwa https://example.com/logo.png

SDK Usage

import { icons } from "icons-cli";

// Generate to files
await icons.pwa.generate("logo.png", {
  output: "./public",
});

// Generate to buffers (no file I/O)
const buffers = await icons.pwa.generate("logo.png");

// With options
await icons.ios.generate("logo.png", {
  output: "./ios-assets",
  zip: true,
});

SDK Options

Option	Type	Default	Description
output	string	undefined	Output directory. Returns buffers if not set
zip	boolean	false	Create zip archive
verbose	boolean	false	Show console output
force	boolean	false	Overwrite existing files

Available Providers

import { icons } from "icons-cli";

// Apple platforms
icons.ios.generate(input, options);
icons.ipad.generate(input, options);
icons.iphone.generate(input, options);
icons.macos.generate(input, options);
icons.tvos.generate(input, options);
icons.watchos.generate(input, options);

// Other platforms
icons.android.generate(input, options);
icons.electron.generate(input, options);
icons.favicon.generate(input, options);
icons.pwa.generate(input, options);
icons.tauri.generate(input, options);
icons.web.generate(input, options);
icons.windows.generate(input, options);

// Browser extensions
icons.chrome.generate(input, options);
icons.firefox.generate(input, options);
icons.safari.generate(input, options);

// Apps
icons.discord.generate(input, options);
icons.og.generate(input, options);
icons.slack.generate(input, options);
icons.vscode.generate(input, options);

// Social Media
icons.facebook.generate(input, options);
icons.instagram.generate(input, options);
icons.linkedin.generate(input, options);
icons.tiktok.generate(input, options);
icons.twitter.generate(input, options);
icons.youtube.generate(input, options);

Recommended Input

For best results, use a 1024x1024 PNG with transparency.

Provider	Recommended Size
iOS, iPhone, iPad, Android, macOS	1024x1024
watchOS	1024x1024
tvOS	1280x1280
Windows, Electron, Tauri	1024x1024
PWA, Favicon, Web	512x512
Chrome, Firefox, Safari	128x128
VS Code	256x256
Discord, Slack	512x512
OG Images	1200x630
Twitter, LinkedIn, TikTok	400x400
Instagram, Facebook	1080x1080
YouTube	2560x2560

Supported Input Formats

PNG, JPEG, WebP, AVIF, TIFF, GIF, SVG

License

MIT