Skip to content

UI icons docs

Troubleshooting

The usual problems with installs and packages, and the fix for each.

DocsTroubleshooting

Coming later. The packages aren't out yet, so these fixes are for when they are. For anything on this site today, write to us.

npm says 401 or "Unable to authenticate"

npm reached the Pro registry but didn't send a working key. Check both of these in the same terminal you install from:

Terminal
echo $ICONOVEN_KEY
npm config get @iconoven-pro:registry
  • If the first line is empty, the key isn't set in this shell. Add the export line to your shell profile and open a new terminal.
  • In CI, the secret has to be passed to the install step as ICONOVEN_KEY. See build servers.
  • If you rolled your key, the old one stops working at once. Update it everywhere you use it.
  • A refunded order's key is switched off.

npm says 404 for @iconoven-pro

npm looked for the package on the public registry. The second line above should print https://npm.iconoven.com/. If it doesn't, the .npmrc isn't next to the package.json you're installing from, or the scope line has a typo. In a monorepo, put it at the root.

pnpm

  • pnpm reads the .npmrc in the workspace root. A copy in a package folder is ignored.
  • After changing the key, run pnpm install again; there's no need to clear the store.

Yarn

  • Yarn 2 and later ignore .npmrc. Use .yarnrc.yml as shown in Pro setup.
  • Error YN0041 is the same as a 401: the key is missing or wrong.

Xcode doesn't see new icons

For the free package, choose File, Packages, Update to Latest Package Versions. If Xcode still shows the old set, choose File, Packages, Reset Package Caches, or clear the cache and reopen the project:

Terminal
rm -rf ~/Library/Caches/org.swift.swiftpm

For Pro, make sure you replaced the whole IconOvenPro folder with the new download.

Icons look thin or blurry

At 16 px, a 1.5 stroke falls between pixels. Use a stroke of 1.75 or 2 at small sizes, and keep icons at whole-pixel sizes and positions.

Still stuck?

Email hello@iconoven.com with the error, your package manager and its version. For an order, include its number (it starts with IO-). Never send your full key: the last four characters are enough.

Your cart

Your cart is empty.

Browse icons