@shotlingo/app-icon-sizes

App icon size requirements for iOS, Android (adaptive icon safe zones included), macOS, and watchOS as a typed lookup table. Zero dependencies, no network calls.

Full interactive reference (searchable table + JSON/CSV export): shotlingo.com/tools/app-icon-sizes

Install

npm install @shotlingo/app-icon-sizes

Usage

import { getById, getByPlatform, getRequired, ICON_SIZES } from '@shotlingo/app-icon-sizes';

getById('ios-app-store');
// => { id: 'ios-app-store', platform: 'ios', usage: 'App Store listing icon', sizePx: '1024×1024', required: true, ... }

getByPlatform('android').map((s) => s.usage);
// => ['Adaptive icon foreground layer', 'Adaptive icon background layer', 'Legacy launcher icon (xxxhdpi)', ...]

getRequired().length;
// => every mandatory icon slot across all four platforms

ICON_SIZES.length;
// => 21

API

• ICON_SIZES: IconSize[] — the full list.
• PLATFORMS: IconPlatform[] — 'ios' | 'android' | 'macos' | 'watchos'.
• getById(id: string): IconSize | undefined
• getByPlatform(platform: IconPlatform): IconSize[]
• getRequired(): IconSize[] — mandatory slots only.

Each IconSize includes usage, sizePx, scale, format, required, a tip (e.g. Android's 72×72dp adaptive-icon safe zone, or macOS's ~10% padding requirement), and a sourceUrl pointing at the platform's official guideline.

License

MIT