Overview

3.5.0 renamed or merged 654 icon names. Nothing breaks when you upgrade: every old name keeps working until 4.0.0, and tells you its new name while it does.

What changed

Names say what the icon draws. Variants used to be told apart by a number or a vague suffix: Bag2, Bag3, SettingsMinimalistic, CopyAlt. Each is now named for what it draws. Names that described the wrong thing were corrected, and so were spelling and capitalisation inherited from the source sets.

Before After Why
IconBag2 IconBagStraps A bag with two strap lines
IconCartLarge3 IconCartLargeSlats A cart with slatted sides
IconMicroscope IconTelescopeAngled It draws a telescope
IconNotebook IconLaptop It draws a laptop
IconMagnifer IconMagnifier Spelling
IconFileFavourite IconFileFavorite One spelling across the set
IconCPU IconCpu One capital in acronyms, as in IconWifi

Duplicates are merged. Fifty icons drew the same symbol as another icon under a second name. Each of those names now renders the icon it duplicated: IconPlusCircle renders IconAddCircle, and IconTickSquare renders IconCheckSquare. Folding them took the set from 2,154 icons to 2,104, and eight new keyboard keys bring 3.5.0 to 2,112.

Bold matches Outline. 36 icons used to draw their Bold and Bulk styles as a glyph cut out of a filled square. They now draw the glyph itself, so switching variant changes weight, never shape. Nothing to migrate, but worth a look if you used one of them as a filled button.

One version number. All 13 packages are at 3.5.0 and release together. The Vue, Svelte, React Native and SVG packages jump from 2.x, and nothing in them breaks.

Every rename is in the searchable list, and in the package as @devigner-ui/icons/renames.json.

How you will be told

Until 4.0.0, an old name renders exactly the same icon as its new one, and:

  • Your editor strikes it through, and hovering it shows the new name. Lint rules for deprecated APIs, such as @typescript-eslint/no-deprecated, flag it as well.
  • The console shows one warning per old name during development:
    Output
    [@devigner-ui/icons] IconBag2 was renamed to IconBagStraps and will be removed
    in @devigner-ui/icons 4.0.0. Update the import, or run:
    npx @devigner-ui/icons migrate
    Production builds never show it.
  • This site finds icons by their old names, says "Formerly IconBag2" on the icon's page, and redirects old icon addresses to the new ones.
  • The CLI answers npx @devigner-ui/icons info Bag2 with the current name.

Your package

Each package carries the old names its own way. The guides cover what changes for you, and anything the codemod cannot reach:

Angular, Solid, Nuxt, plain JavaScript, MCP, Rails, Flutter and Blazor launched with 3.5.0 and only know the new names. If you use one of them, there is nothing to migrate.

When old names stop working

In 4.0.0, in every package at once. A major release is the only kind that removes anything; Upcoming 4.0 says what it will remove and how to check you are ready.

Documentation

Browse all 12,480 icons