Migrate from GuideGuide 5

Due to limitations and privacy features of many modern design tools, GuideGuide can no longer store data in a centralized place on your device. Furthermore, the latest versions of GuideGuide cannot look for old GuideGuide data you have stored without your help. It’s annoying as a user, I know, but in the long run, these sort of privacy limitations are good things.

To migrate your data from GuideGuide 5 to the latest versions of GuideGuide, you will need to locate your old data file, then manually import it into GuideGuide.

Locate your data

MacOS

Photoshop data may be stored in the following locations:

/<USER>/Library/Application Support/GuideGuide/storage.json /<USER>/Library/Application Support/Adobe/UXP/SPRK/External/88412c37/PluginData/storage.json

Windows

Photoshop data may be stored in the following locations:

C:\Users\<USER>\AppData\Roaming\GuideGuide\storage.json C:\Users\<USER>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\88412c37\PluginData\storage.json

Migrating

  1. Click the Settings button.
  2. Click Import data.
  3. You will be asked to locate the file with data you would like to import. Navigate to one of the paths above to import your old data.
  4. Once your data is imported, you will see a confirmation message.

Migrating Grid Notation

The current version of Grid Notation has a few breaking changes from the first version of Grid Notation that shipped in GuideGuide 5. When you import v1 grids using the process above, they will automatically be updated and comments will be added to your grids to indicate what has changed. However, if for some reason you need to update your grids manually, you can do the following:

  • Remove any commas

    # Before
(vlp, 100px)
# After
(vlp 100px)

  • Remove any “adjustment” options. Instead, use wildcards and commands within your grids to adjust positioning. If your adjustments contain three values, the middle value should be used as the size for the updated grid.

    # Before
| 100px | (hlp,  ~ | ~ )
# After
~ | 100px | ~ (hlp)

  • Change the name of any variables that are called $WIDTH or $HEIGHT.

    # Before
$WIDTH = | ~ |
# After
$myWidth = | ~ |

  • Change any variable names that contain anything other than $, letters, or numbers

    # Before
$thisGridIsSh!t = | ~*1000 |
# After
$thisGridCouldBeBetter = | ~*1000 |

Uninstall GuideGuide 5

If you’ve instaled a newer version of GuideGuide, you might have two versions of GuideGuide installed now. Here’s how to uninstall the older version of GuideGuide.

MacOS

To remove GuideGuide 5 from Adobe apps, delete any of the following folders. You may have to enter your password to do so.

  • /Library/Application Support/Adobe/CEP/extensions/me.guideguide.adobeextension
  • ~/Library/Application Support/Adobe/CEP/extensions/me.guideguide.adobeextension

To remove GuideGuide 5 from Sketch:

  • In Sketch, go to Plugins > Manage Plugins
  • Right click the version of GuideGuide that is 5.0.*
  • Select Uninstall “GuideGuide”

Windows

To remove GuideGuide 5 from Adobe apps, delete any of the following folders. You may have to enter your password to do so.

  • C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\me.guideguide.adobeextension
  • C:\Program Files\Common Files\Adobe\CEP\extensions\me.guideguide.adobeextension