Upcoming 4.0

4.0.0 is the release that removes the old icon names 3.5.0 replaced. It has no date yet. Nothing else in it is planned to break, and this page will say so if that changes.

What 4.0 removes

In every package at once, since they share one version:

  • The old component names, such as IconBag2, from @devigner-ui/icons, -vue, -svelte and -react-native, and their subpaths.
  • The old SVG files and sprite ids in @devigner-ui/icons-svg, such as svg/outline/Bag2.svg and #Bag2.

What stays: every icon, under its current name, and renames.json, so the codemod can still update a project that skipped 3.5 entirely.

Get ready

  1. Upgrade to 3.5 and run npx @devigner-ui/icons migrate; see the codemod.
  2. Open your app in development and look for was renamed to … and will be removed in … 4.0.0 in the console.
  3. Pin unversioned CDN links to the SVG package, or move them to new names; see SVG and sprites.

Check it in CI

migrate --dry changes nothing and says No old icon names found. when a project is ready. Fail the build when it says anything else:

YAML
# .github/workflows/icons.yml
name: Icon names
on: [pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx @devigner-ui/icons@^3.5.0 migrate --dry | grep "No old icon names found."

The step fails, and its log lists every file and line still using an old name.

Skipping 3.5

Upgrading straight from 3.4 or earlier to 4.0 works too: run the codemod first and it updates every name, since it reads the full rename history rather than the aliases 4.0 removes.

Documentation

Browse all 12,480 icons