Replaces a set of colors with a given set of colors

Usage no npm install needed!

<script type="module">
  import sketchmineSketchColorReplacer from 'https://cdn.skypack.dev/@sketchmine/sketch-color-replacer';


Github banner for sketchmine


The sketch-color-replacer is a CLI tool for replacing a set of legacy colors with new colors. We had the need @Dynatrace to replace over 80 colors, over multiple files with the new brand colors.

Dependency graph

Dependency graph of the sketchmine sketch-color-replacer


The color-replacer needs a ./colors-json file provided with the colors that need to be replaced and of course a .sketch file where the replacement should be applied.

The colors.json file follows following convention:

  "legacycolor": "newcolor",
  "#AJ54K0": "#333333",


Installing the package can be performed with yarn or npm. yarn add @sketchmine/sketch-color-replacer will add the executable and the typings to your node_modules folder.

Run the replacer

To execute the colors replacer you can go ahead with the .bin like npx skm-color-replacer --colors /path/to/colors.json --file /path/to/file.sketch.

Want to contribute?

If you find a bug or a missing feature, please let us know your solution so that we can document it

Building the package

For building the package Rollup.js is used as a module bundler. The configuration can be found in the rollup.config.js and is orchestrated by the yarn package manager. The package bundle is in the commonjs format and meant to be consumed only be node.js applications.

The build can be started with the following two commands:

  • yarn build for building the package.
  • yarn dev for building and watching the sources of the package. (rebuilds after safe)


The source code of this package is going to be linted by our CI environment. To ensure a coding standard and quality use the configured linter tslint. This package extends from the tslint-config-airbnb and the linting configuration extends from the root tslint.json.

run yarn lint to execute the linter.


Sorry but currently there are no tests specified. 😭 Feel free to add some! 💪🏻