Use this guide to update quasar-extras-svg-icons within v3 or migrate an older application from v2.

This package is not a Quasar app extension. Install it as a package dependency and import icons directly from the generated icon-set folders.

Check the Releases page for the latest notes before publishing an app that depends on a specific icon set.

Updating within v3

Version 3.4.2 refreshes upstream icons and adds Health Icons v3 and Cool Icons v5. Health Icons v2 and Cool Icons v4 remain available as retained snapshots. Health Icons v1 and the unversioned Cool Icons v2.5 catalog are retired under the two-major-version policy.

1. Check your named imports against the excluded icon lists.
2. Remove affected imports or select another supported icon. If you need the original artwork, use the upstream SVG through QIcon’s img: support.
3. Rebuild and typecheck your application to find any remaining imports of excluded names.

The ESM package structure and QIcon path-string format remain the same.

Earlier migration: v2 to v3

The v3 line refreshes the package for the current Quasar 2 and Quasar CLI Vite generation while keeping the icon exports simple for devland usage.

Important changes:

• Package tooling now uses the shared v3 migration stack: pnpm, oxlint, oxfmt, TypeScript, and Quasar CLI Vite 3 for docs.
• Documentation uses Q-Press and includes an in-site release history.
• Icon metadata is generated from shipped type declarations so docs reflect the package output.
• Icon-set majors are kept side-by-side where practical, with at most the current major and the immediately preceding major.
• Known problematic SVG features are documented so consumers can understand missing or altered icons.

Requirements

Installing v3

Install the package from the default npm dist tag.

pnpm add quasar-extras-svg-icons

Updating Imports

Prefer explicit imports from the icon-set folder you want:

import { tabOutlineMenu } from 'quasar-extras-svg-icons/tabler-icons-v3'
import { remBugLine } from 'quasar-extras-svg-icons/remix-icons-v4'

If you previously used an unversioned folder and an icon family has moved forward, check the Icon Finder for the current folder and export name.

Versioned Icon Folders

Some icon families are shipped in multiple major versions. In those cases:

• The package keeps at most two majors: the current major and the immediately preceding major.
• When a newer major is added, the oldest shipped major and its import path are removed.
• Use the versioned folder when stability matters, such as simple-icons-v16.
• Use the unversioned folder only when you are comfortable following the package’s current default for that family.
• Review your imports after package upgrades if an upstream icon family has a new major release.

Known SVG Limitations

Some upstream SVGs cannot be flattened into Quasar’s icon string format. Common blockers include:

• mask
• use
• clipPath
• gradients
• filters
• malformed view boxes

The Introduction page tracks known package-specific limitations.

Unsupported icons are excluded and documented in each affected set’s README. The generated runtime exports, TypeScript declarations, and icon lists all omit those names.

Contributor Tooling Changes

The repository currently pins these contributor tools:

• pnpm@12.16.1 through the root packageManager field
• Node.js >=22.22.0
• oxlint instead of ESLint
• oxfmt instead of Prettier
• Quasar CLI Vite 3 for docs

Use the existing scripts for local verification:

pnpm format:check
pnpm lint
pnpm test:smoke
pnpm build
pnpm typecheck