Troubleshooting
Favicon doesn't update
Browsers cache favicons aggressively.
- Hard refresh —
Ctrl+Shift+R/⌘Shift+R. - Try a private window.
- Cache-bust while iterating:
icon.svg?v=2.
PWA icon missing
- Confirm
manifest.webmanifestis served asapplication/manifest+json(application/jsonworks in practice). Vercel and Next.js handle this by default; static hosts may need a MIME override. - DevTools → Application → Manifest for parse errors.
- Icon paths in the manifest must be absolute (start with
/).
iOS home screen icon missing
iOS Safari needs either the exact apple-touch-icon.png filename at the site root or an explicit <link rel="apple-touch-icon">. The Web bundle ships both.
Export fails
Refresh and retry. If the design uses a font, try a different one — font loading or outlining can fail on edge cases.
Download doesn't appear
Check the browser's downloads list. If downloads are being blocked, temporarily disable "Ask where to save each file".
Font appears unchanged
The font didn't load; the browser is using a fallback. Try a different font or refresh.
"Free plan limit reached"
Free plan caps saved designs at 5. Delete one or upgrade.
Sharing link loads defaults
iconconfig failed to decode or validate. The editor opens with defaults and a warning banner — re-generate the link from the source.