Troubleshooting Sketch

Mar 24, 2015

Somewhere between version 3.0 and 3.2 I noticed some issues when using Sketch. After some trial and error, I found the following steps fixed issues for me and a few other people.

What issues has this solved?

So if you’re having similar problems, here’s a quick checklist of steps you should try before creating a bug report or kvetching on Twitter.

1. Back up any plugins you want to keep (optional)

You can find the Plugins folder by opening Sketch, clicking on Plugins in the app menu, and clicking Reveal Plugins Folder….

Reveal Plugins Folder

Another way to find the Plugins folder is by navigating to: ~/Library/Containers/com.bohemiancoding.sketch3/Data/Library/Application Support/com.bohemiancoding.sketch3/Plugins

Make a copy of your plugins by creating a folder somewhere else (like the Desktop) and moving your plugins there for safe keeping. We’ll be moving them back shortly.

2. Delete Sketch and its config files

The simplest way to do this is by downloading and running AppCleaner.

AppCleaner is a free tool that helps you completely remove all the files apps put on your system when they’re installed. To use it, install it and drag Sketch into the window. AppCleaner will create a list of files it thinks belongs to Sketch. Your list should look something like this:

Reveal Plugins Folder

Important: Read through the list before clicking Delete. Your backup folder might be in there depending on where you put it. In my list, all the files/folders you should delete begin with com.bohemiancoding. If you’re unsure about something or don’t want to delete it, simply uncheck the checkbox next to any file you want to keep. AppCleaner only moves the files to the Trash so if you need to restore a file, you can find it in the Trash and put it back.

When you’re happy with the list of files to be deleted, click Delete. AppCleaner will probably prompt you for an admin password because Apple locks down apps installed from the App Store.

3. Repair Permissions

Open up Disk Utility from Applications/Utilities.

Select your hard drive (usually the second Macintosh HD listed). Click Repair Disk Permissions.

Reveal Plugins Folder

Get a cup of coffee and let Disk Utility do its thing. You should see a list of things Disk Utility repaired. When it’s finished, restart your computer.

4. Reinstall Sketch

Open the App Store app and reinstall Sketch. When it’s finished installing, open Sketch and see if the issue is fixed.

Everything fixed? Awesome! If you backed up plugins from Step 1, you can now put things back.

Still having issues? Check out the Sketch support site to find other solutions or find directions on reporting bugs.

5. Put your plugins back (optional)

To put your plugins back, just open the Plugins folder from Step 1 and move your plugins from your temporary backup folder back to the Plugins folder.

6. Enjoy!

Happy Sketching!

Do you want to learn how to design web apps that people love using?

Sign up for my newsletter to receive free updates on the latest articles, advice, and learning resources to help you design software and websites that don't suck.

I hate spam. I won’t use your email for evil and you can unsubscribe any time.