Registry / web-framework / rollup-plugin-iconify-svg

rollup-plugin-iconify-svg

library2.2.4jsnpmunverified

A Rollup plugin that automatically generates SVG markup from Iconify icon references in Svelte projects. Version 2.2.4. It scans source files for Iconify syntax (e.g., 'fa:random'), fetches SVG data from the Iconify API, and bundles the icons into your app. Offers both JS object output and experimental SVG file output. Provides options for recursive search, logging, and always-save mode. Differentiators: offline-capable after initial fetch, no runtime API calls, and fast iteration compared to manual icon export.

web-framework

npm install rollup-plugin-iconify-svg

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-ICON

rollup-plugin-iconify-svg

web-frameworkjavascriptv2.2.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import rolluppluginiconifysvg from 'rollup-plugin-iconify-svg'

✗ const rolluppluginiconifysvg = require('rollup-plugin-iconify-svg')

Plugin is ESM-only; requires use of import. CommonJS require will not work.

Shows setup in rollup.config.js with a single target to generate src/icons.js from src.

// rollup.config.js import svelte from 'rollup-plugin-svelte'; import resolve from '@rollup/plugin-node-resolve'; import rolluppluginiconifysvg from 'rollup-plugin-iconify-svg'; export default { input: 'src/main.js', output: { format: 'iife', name: 'app', file: 'public/build/bundle.js' }, plugins: [ rolluppluginiconifysvg({ targets: [{ src: 'src', dest: 'src/icons.js' }] }), svelte(), resolve({ browser: true }), // ... other plugins ] };

Debug

Known issues

gotchaWatch mode can cause infinite rebuilds if dest file is within watched src directory.

fix

Add dest file to watch exclude: watch: { exclude: ['src/icons.js'] }

affects: >=1.0.0

gotchaPlugin relies on Iconify API; no internet connection will cause build failure.

fix

Ensure network access or cache API responses. Use alwaysSave: true to force refresh.

affects: >=1.0.0

gotchaThe plugin writes a .js file to disk; ensure write permissions in dest directory.

fix

Check file system permissions or adjust dest path.

affects: >=1.0.0

gotchaIf using livereload, you may need to add a delay to allow icons file to be created.

fix

Add livereload({ watch: 'public', delay: 1000 })

affects: >=1.0.0

gotchaCommonJS mode (commonJs: true) is deprecated; prefer ESM imports.

fix

Use default ESM import; set commonJs: false.

affects: >=2.0.0

Errors

Common errors & fixes

Error: ENOENT: no such file or directory, open 'src/icons.js'

Plugin tries to write to a directory that doesn't exist or lacks permissions.

fix

Ensure dest directory exists and is writable, e.g., 'src/'

Error: Network request to Iconify API failed

No internet connection or API endpoint unreachable.

fix

Check internet connection; consider caching responses or using offline fallback.

Error: Could not resolve 'rollup-plugin-iconify-svg' (did you mean 'rollup-plugin-iconify-svg'?)

Package not installed or missing from node_modules.

fix

Run 'npm install rollup-plugin-iconify-svg --save-dev'

Upgrade

Version history

2.2.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Swiftaff/rollup-plugin-iconify-svg ↗

packagehttps://www.npmjs.com/package/rollup-plugin-iconify-svg ↗