developer tools - migration tool Frequently Asked Questions

A free CLI (@hugeicons/migrate) that moves a React project from another icon library to Hugeicons. It finds every icon import, maps each one to a Hugeicons equivalent, and rewrites your imports, JSX and TypeScript types. Run it with npx @hugeicons/migrate.

Lucide, Font Awesome, Heroicons, Feather, Tabler and Phosphor, in React projects.

Commit your work, then run these from your project root:

npx @hugeicons/migrate plan .           # review the icon mappings
npx @hugeicons/migrate apply .          # dry run, no files changed
npx @hugeicons/migrate apply . --write  # apply the migration

The tool installs the Hugeicons packages and turns <Home /> from lucide-react into <HugeiconsIcon icon={Home01Icon} />. Font Awesome, Heroicons and the other supported libraries use the same steps.

Not automatically. Those imports aren't detected, including Lucide icons imported through react-icons/lu. To switch by hand, install @hugeicons/react and @hugeicons/core-free-icons, find each equivalent on hugeicons.com, and render it with <HugeiconsIcon icon={...} />. If your icons go through one shared wrapper component, you only need to update that wrapper.

Not yet. The tool only supports React projects. For other frameworks, install the Hugeicons package for that framework and replace icons by hand.

They keep their original import, so your app still builds. The migration report lists them so you can swap them by hand. Also review the plan before applying: about 70–90% of icons use hand-picked mappings, and the rest are matched by name, which can occasionally pick the wrong icon.

Run npx @hugeicons/migrate revert . to restore the automatic backup the tool made before changing any files. The backups are stored in .hugeicons-migration-backups/.

Yes, with a Pro license. Run apply . --style pro --write and enter your license key when asked. The tool saves the key in .npmrc (or your package manager's config file), so don't commit that file to a public repository.