ImageConver · Day 18 · Platform icon guide
PWA Icon Sizes Guide
Plan PWA icons by separating general-purpose, maskable, monochrome, shortcut, and platform-specific artwork. A dependable baseline includes correctly declared 192×192 and 512×512 PNG icons, while installation quality depends on manifest paths, purpose values, safe zones, HTTPS delivery, and browser testing.
ตอบตรง
What this page produces and where it fits
Plan PWA icons by separating general-purpose, maskable, monochrome, shortcut, and platform-specific artwork. A dependable baseline includes correctly declared 192×192 and 512×512 PNG icons, while installation quality depends on manifest paths, purpose values, safe zones, HTTPS delivery, and browser testing. This guide addresses web app manifest imagery. It does not make a site installable by itself, generate service workers, configure iOS touch icons automatically, guarantee app-store acceptance, or predict every browser and operating-system presentation.
Icon work is a delivery system, not a single resize. A platform may use the same identity in a store, launcher, notification, settings screen, browser tab, installed web app, shortcut, or operating-system search result. Each context can apply a different mask, density, cache, compositing rule, or validation step. The recommended icon system should therefore be treated as a tested derivative of an editable brand master.
Begin with clean source artwork. Keep the primary subject centered, remove unnecessary text, avoid hairline details, and judge the design at the smallest real display size. Do not add a platform’s outer rounded mask or system shadow to the source unless current official guidance explicitly requires that treatment. A large preview can hide problems that become obvious at 16, 32, or 48 pixels.
File dimensions alone do not prove correctness. Confirm color space, alpha behavior, file paths, MIME types, manifest or asset-catalog metadata, purpose declarations, naming, cache behavior, and actual device presentation. Preserve the source file and document which generator settings produced the reviewed release assets.
ขั้นตอนการทำงาน
A controlled four-step icon process
- 1
Inspect the source
Inventory installation targets and decide which icon purposes and shortcuts are actually needed.
- 2
เลือกการตั้งค่า
Create separate full-bleed general and maskable artwork from an editable master.
- 3
Generate assets
Declare source paths, exact sizes, MIME types, and purpose values in the manifest.
- 4
Validate delivery
Run browser audits, inspect network delivery, install the PWA, and review real device surfaces.
Visual quality
Fit, detail, transparency, and recognition
Framing and padding
Fit mode changes meaning. Contain keeps the complete source and can add background around it; cover fills the square and can crop edges. Padding is useful for centered marks, but too much creates a small-looking icon. Compare masks and tiny previews before accepting a value.
Small-size detail
Raster downsizing removes detail. Thin strokes, small counters, photographic textures, and type can blur or disappear. The best small icon is often a simplified drawing rather than a mechanically reduced version of marketing artwork. Review the actual pixel output at 100% scale.
Background behavior
Transparency is not neutral. A browser, launcher, store, or operating system may composite transparent pixels against a color you did not choose. Full-bleed platform artwork should use a deliberate background where guidance expects one, while formats such as ICO may intentionally retain alpha.
Color contrast and recognition matter across light, dark, tinted, and themed environments. Test the icon near competing icons and against multiple backgrounds. Automated generation cannot determine whether a mark is distinctive, accessible, legally cleared, or consistent with current brand rules.
Important limits
What automated icon generation cannot guarantee
- Installability criteria and icon handling vary among browser engines and operating systems.
- An icon file can be valid while its manifest URL, MIME type, or cache behavior is wrong.
- Maskable safe-zone compliance does not guarantee strong visual design.
- Apple touch icons and other platform-specific resources may still be needed outside the manifest.
Use cases
Where this page fits in production
Product delivery
Plan a new PWA icon package.
Compatibility work
Fix missing or blurry installed-app artwork.
Quality review
Add maskable imagery without breaking ordinary icons.
Developer handoff
Audit manifest paths and purpose declarations before launch.
Implementation
Configuration, caching, and release checks
Keep generated files at stable, cache-aware URLs. A manifest or HTML declaration that points to a missing file is not rescued by having the right PNG on a developer’s computer. Verify HTTP status, content type, dimensions, file bytes, and same-origin or cross-origin behavior where relevant.
Treat configuration files as reviewable code. Inspect every manifest entry, asset-catalog record, folder name, scale factor, purpose token, and filename before merging. A generated fragment intentionally avoids guessing application names, start URLs, bundle identifiers, theme colors, or project settings that belong to the real application.
Cache invalidation deserves a release check. Installed web apps, browsers, launchers, build systems, and stores can retain old icon resources. Use deliberate versioned paths or cache policy, rebuild the application, reinstall when necessary, and distinguish a stale resource from an incorrectly generated resource.
Validate both geometry and workflow. Geometry includes cropping, safe zones, centering, edge treatment, and small-size clarity. Workflow includes correct source control, repeatable settings, platform configuration, build output, deployment, and rollback. A visually attractive file can still fail because the project references a different filename.
Decision framework
Build the icon set from requirements, not habit
Write down the supported operating systems, browser engines, application targets, project tooling, and distribution channels before selecting files. A list copied from an old blog can be internally consistent yet wrong for a current project. Official platform documentation and the project’s own build warnings are the controlling evidence.
Separate master artwork from delivery derivatives. The master remains editable and high resolution; platform files are reproducible outputs. Keep appearance variants and semantic layers distinct when the platform expects them. Do not ask a resize operation to invent foreground, background, monochrome, dark, or tinted design intent.
Use the table as a starting inventory, then remove assets the project genuinely does not consume and add only requirements supported by official documentation or validated target behavior. Every retained asset needs an owner, source, generation method, configuration reference, and test surface.
Run a release audit after integration. Confirm each generated file is present in the built package or deployed location, referenced by the correct metadata, served with the expected MIME type, and visible after a clean installation. Capture screenshots or build evidence for the supported target matrix.
Recheck guidance when platform tooling changes. Icon pipelines are unusually sensitive to new masks, appearance systems, asset-catalog formats, installation criteria, and store validation. Record the review date and do not present historical dimensions as timeless requirements.
| Purpose | Starting assets | Validation |
|---|---|---|
| General install | 192×192 and 512×512 PNG, purpose any | Manifest fetch and install audit |
| Maskable | Full-bleed PNG with essential content inside 40% radius safe zone | DevTools safe-area preview and real devices |
| Shortcuts | Context-specific icons declared on shortcut items | Installed shortcut surfaces |
| Apple Home Screen | Separate apple-touch-icon resources | Safari and physical devices |
Production checklist
Document the asset inventory and test matrix
Create an inventory before implementation. For each asset, record its platform context, logical purpose, pixel or point dimensions, scale factor, filename, source-art revision, background and alpha policy, configuration reference, and the application or browser that consumes it. This prevents two files with similar dimensions from being treated as interchangeable when their semantics differ.
Define a representative test matrix rather than checking only the developer’s primary device. Include the minimum and maximum supported operating-system versions, relevant density classes, at least one light and dark environment, required appearance or theme variants, and the installation or distribution channel. For web applications, include a clean browser profile and a reinstall after cache changes. For native applications, include a release-style build rather than only an editor preview.
Review small contexts independently. Open exported pixels at 100% scale, place them beside typical neighboring icons, and check silhouette, contrast, edge clarity, and recognition without relying on the app name. Record defects against the editable master so the next iteration changes the design source rather than painting corrections into generated derivatives.
Keep generation reproducible. Save the approved master, generator version or script, settings, official references, review date, and validation evidence together. Checksums can identify the exact files reviewed. If a platform rejects or transforms an asset, preserve the rejection message and resulting presentation because that evidence is more useful than guessing from a generic size list.
Plan maintenance ownership. Someone must recheck platform documentation, build warnings, installation behavior, and store validation when supported targets or tooling change. Retire obsolete files only after proving they are no longer referenced by source code, manifests, asset catalogs, deployment templates, cached application data, or release automation.
ความเป็นส่วนตัว
Local processing and asset handling
The browser reads the selected source with local file APIs, draws derivatives to canvas, encodes PNG data, and assembles the requested ZIP or ICO in memory. ImageConver does not send source pixels to an icon conversion endpoint in this workflow.
Local processing reduces transfer exposure but does not make a shared device private. Browser downloads, recent-file lists, synchronized folders, backups, extensions, and operating-system previews may retain copies. Use an approved workstation for unreleased brands or confidential product artwork.
Generated object URLs are temporary and are revoked when replaced or reset. Move reviewed assets into controlled project storage, retain the editable master, and close the tab after handling sensitive materials.
คำถามทั่วไป
PWA Icon Sizes Guide FAQ
What is the minimum practical PWA icon set?
For Chromium installation, provide at least 192×192 and 512×512 raster icons and declare them correctly in the manifest.
What does purpose any mean?
It marks an icon for general presentation. It is the default purpose when no purpose is specified.
What does purpose maskable mean?
It tells the user agent that edge content can be cropped by a platform mask while essential content remains in the safe zone.
Should normal and maskable icons be separate?
Usually. Separate artwork lets the normal icon retain intentional whitespace while the maskable icon uses a full-bleed background.
Do I need a 1024×1024 icon?
It can improve high-resolution and platform-specific workflows, but Chromium guidance specifically calls for at least 192 and 512 pixels.
Can I use sizes any for SVG?
Manifest syntax supports scalable resources, but use raster fallbacks because implementation and installation behavior vary.
Why does the installed icon not update?
Browsers and operating systems cache manifest resources aggressively. Verify URLs, cache headers, manifest fetches, and reinstall behavior during testing.
การอ้างอิงเบื้องต้น
Current platform documentation
- web.dev: Add a web app manifest
- web.dev: Adaptive icon support with maskable icons
- W3C Web Application Manifest specification
Last reviewed: October 20, 2026. Platform requirements and tooling change; verify release-critical assets against current primary documentation.