Skip to content
A small Sketch plugin to store and restore override values before and after library updates
Branch: master
Clone or download
Latest commit 5a4c8ba May 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.sketchpacks add .sketchpacks May 7, 2019
assets setup plugin May 6, 2019
sketch-assets setup plugin May 6, 2019
src Setup sketchpacks May 7, 2019
.appcast.xml Update .appcast with new tag May 7, 2019
.gitignore setup plugin May 6, 2019
README.md Update README.md May 7, 2019
package-lock.json Publish 0.3.0 release 🚀 May 7, 2019
package.json Update README and application name May 7, 2019

README.md

Restore Overrides

This plugin is a workaround for Library updates that reset override values on symbol instances. This happens when a symbol containing a string value is replaced with a different symbol, and the override can no longer map to the new symbol.

Download from Sketchpacks.com

Installing Plugins

Install from download

  1. Download the ZIP file and unzip
  2. Open restore-overrides.sketchplugin

Install with Sketchpacks

  1. With Sketchpacks, search for Restore Overrides
  2. Click Install
  3. Get automatic updates for Restore OVerrides

Already have Sketchpacks?

Install Restore Overrides with Sketchpacks

Install with Sketch Runner

With Sketch Runner, just go to the install command and search for Restore Overrides. Runner allows you to manage plugins and do much more to speed up your workflow in Sketch. Download Runner here.

Usage

This plugin must be run sequentially in the following order:

  1. Open the document and do not update the library
  2. Run the Override Export command. This will create a JSON document at ${homeDirectory}/sketch-restore-overrides/${documentName} containing the values of every override from every symbol instance from every artboard on every page in your document. Very large files (hundreds of artboards) may take up to 30 seconds.
  3. Accept the library updates.
  4. Run the Override Import command. This will find the generated JSON file and try to reset the values on the newly updated symbols.

Things to look out for

This plugin has a few gotchas, most notably, it only works on text values. All other override types are not supported at this time. Additionally, Sketch doesn't appear to provide unique UUIDs for each override of the same type, so if you have a group of the same symbol- for example, list items- The override values all get the same ID. The current work around for this is to remove each item from the list as it is set. Because of this, the order of your symbol instances must not change from the time you export to the time you import.

Roadmap

  • Add tests
  • Add ability to install from Sketch Runner and Sketch Packs
  • Add support for other override types
You can’t perform that action at this time.