Troubleshooting

Favicon doesn't update

Browsers cache favicons aggressively.

  1. Hard refresh — Ctrl+Shift+R / ⌘Shift+R.
  2. Try a private window.
  3. Cache-bust while iterating: icon.svg?v=2.

PWA icon missing

  1. Confirm manifest.webmanifest is served as application/manifest+json (application/json works in practice). Vercel and Next.js handle this by default; static hosts may need a MIME override.
  2. DevTools → Application → Manifest for parse errors.
  3. 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.

iconconfig failed to decode or validate. The editor opens with defaults and a warning banner — re-generate the link from the source.