Skip to content

Linting tool to check if SVG files use only colors of a given color palette

License

Notifications You must be signed in to change notification settings

PKief/svg-color-linter

Repository files navigation


logo

SVG Color Linter

Linting tool to check if SVG files only use colors of a given color palette.

CLI Command

The tool can be executed with this command:

bunx svg-color-linter --colors colors.yml file1.svg file2.svg

It will fetch all the colors of a YAML file which must have the following structure:

colors:
  - "#FFEBEE"
  - "#FFCDD2"
  - "#EF9A9A"
  - "#E57373"
  - "#EF5350"
  - "#F44336"

It also supports glob file patterns to check multiple files matching the pattern like this:

bunx svg-color-linter --colors colors.yml ./images/**/*.svg ./another-dir/*.svg test.svg

Programmatic use

The tool can be imported as module into existing JavaScript or TypeScript code. Therefor it is necessary to install it via package manager:

npm install svg-color-linter

The module can be imported like this:

import { isColorInPalette, getSuggestions } from 'svg-color-linter';

isColorInPalette('#FFFFFF', ['#EEEEEE', '#121212']);
// false

getSuggestions('#C0CA35', ['#EEEEEE', '#121212']);
// [
//   { hex: '#C0CA33', distance: 0.160467661071053 },
//   { hex: '#CDDC39', distance: 4.307076277707079 },
//   { hex: '#D4E157', distance: 5.606714639567858 },
//   { hex: '#AFB42B', distance: 5.713845679863578 },
//   { hex: '#DCE775', distance: 8.068630911169271 }
// ]