Restore Overrides

A small plugin to store and restore override values before and after library updates

v0.3.0 is compatible with Sketch 0.0.0

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
  • [x] Add ability to install from Sketch Runner and Sketch Packs
  • [ ] Add support for other override types

Join the discussion

Download v0.3.0
Usage Activity
400100

Avg. user activity in the last 30 days

Stats
  • 25 downloads all–time
  • 7 downloads this week
  • 25 downloads this month
About this plugin

danielthall published this plugin 16d ago.

v0.3.0 is the latest of 2 releases

Native updates are supported within Sketch.app.