Skip to content

knpwrs/vite-plugin-svg-sprite-components

Repository files navigation

vite-plugin-sprite-components-{core,preact,react,solid}

A vite plugin to generate sprite sheets from imported svg files. The imported svg files are transformed into components which can be used in the frontend framework of your choice. For example:

import Icon from './icon.svg?sprite-react';

export function App() {
  return (
    <nav>
      <Icon />
    </nav>
  );
}

icon.svg is packed into a sprite sheet in your build output, and the Icon component renders an inline svg that references said sprite sheet. The Icon component also has properly defined TypeScript types.

See the following examples for specific frameworks, all with TypeScript support:

If your build uses multiple frontend frameworks (e.g., an Astro project with multiple islands), you can set up this plugin to generate components for all of them, and they will all reference the same sprite sheet. See ./examples/multi for a working example.

Release Process

  • Run pnpm changeset
  • Run pnpm changeset version
  • Run pnpm install
  • Commit the changes
  • Run pnpm publish -r

About

Create svg sprite sheets from imported svg files and get usable components for many popular frontend frameworks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published