Skip to content

Astro Icon and Astro Iconset

There are two components for Astro:

  • Astro Icon
  • Astro Iconset

With those components, you can easily use over 300,000 open source icons and custom icons in Astro with minimal code.

Installation

When it comes to Iconify icons, both packages are very similar.

Astro Icon

Install astro-icon:

npm i -D astro-icon

Register the component in your astro.config.mjs:

jsimport { defineConfig } from 'astro/config';
import icon from 'astro-icon';

export default defineConfig({
   integrations: [icon()],
});

Astro Iconset

Install astro-iconset:

npm i -D astro-iconset

Register the component in your astro.config.mjs:

jsimport { defineConfig } from 'astro/config';
import icon from 'astro-iconset';

export default defineConfig({
   integrations: [icon()],
});

Usage

Usage is almost identical for both packages.

Astro Icon

Astro Icon can inline SVG directly in your HTML:

astro---
import { Icon } from 'astro-icon/components'
---

<Icon name="mdi:home" />

It can also generate SVG sprites.

See Astro Icon readme for more details.

Astro Iconset

Astro Icon can inline SVG directly in your HTML:

astro---
import { Icon } from "astro-iconset/components";
---

<Icon name="mdi:home" />

It can also generate SVG sprites.

See Astro Icon readme for more details.

Released under the Apache 2.0 License.