Skip to content
Astro Iconset

Deployment & SSR bundles

Astro Iconset works with any Astro deployment target. This page covers bundle size when using server or hybrid output.

Rendering modes

Section titled “Rendering modes”

Astro supports several rendering modes. Astro Iconset behaves as follows:

  • Static (pre-rendered) pages: No special Iconify bundle tuning is required for most cases.
  • On-demand (server) routes: Iconify data from installed @iconify-json/* packages can be pulled into server JavaScript unless you limit what is included.

Use include for server bundles

Section titled “Use include for server bundles”

Configure include on the integration so only the Iconify icons you need are bundled for SSR. See the include section in the configuration reference.

icon({
  include: {
    mdi: ["account", "home"],
  },
});

This is especially important when many @iconify-json/* packages are installed.

Section titled “Related guides”