forge42dev / vite-plugin-icons-spritesheet

Vite plugin that listens to an icon folder and outputs a spritesheet with optional types to specified location

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

vite-plugin-icons-spritesheet

A Vite plugin to generate a spritesheet with icons from a directory, re-runs on every edit/delete/add to the directory that is being watched.

Optionally generates TypeScript types for the icon names that it outputs.

If you want to learn more about this approach and it's benefits check it out here: https://www.jacobparis.com/content/svg-icons

Installation

npm install -D vite-plugin-icons-spritesheet

Usage

// vite.config.js
import { iconsSpritesheet } from 'vite-plugin-icons-spritesheet';

export default {
  plugins: [
     iconsSpritesheet({
      // Defaults to false, should it generate TS types for you
      withTypes: true,
      // The path to the icon directory
      inputDir: "icons",
      // Output path for the generated spritesheet and types
      outputDir: "public/icons",
      // Output path for the generated type file, defaults to types.ts in outputDir
      typesOutputFile: "app/icons.ts",
      // The name of the generated spritesheet, defaults to sprite.svg
      fileName: "icon.svg",
      // The cwd, defaults to process.cwd()
      cwd: process.cwd(),
      // Callback function that is called when the script is generating the icon name
      // This is useful if you want to modify the icon name before it is written to the file
      iconNameTransformer: (iconName) => iconName
    }),
  ],
};

Example component file:

import spriteHref from "~/path/sprite.svg"
import type { SVGProps } from "react"
import type { IconName } from "~/path/types.ts"

export function Icon({
  name,
  ...props
}: SVGProps<SVGSVGElement> & {
  name: IconName
}) {
  return (
    <svg {...props}>
      <use href={`${spriteHref}#${name}`} />
    </svg>
  )
}

Component usage:

<Icon name="plus" />

About

Vite plugin that listens to an icon folder and outputs a spritesheet with optional types to specified location

License:MIT License


Languages

Language:TypeScript 83.7%Language:JavaScript 16.3%