×

Sync

The Craft Sync plugin for Sketch and Photoshop brings your design environment and InVision together like never before. Sync lets you send your designs into InVision instantly- no saving, exporting, dragging or dropping. Simply select your screens in Sketch or Photoshop, create or choose the prototype you want to sync to, and easily import all of your screens into InVision.

Currently Craft Sync works differently for Sketch and Photoshop, and we’ll elaborate on the differences between those flows below.

Over the next few months, we’ll be improving Craft Sync functionality. See below for known limitations, and stay tuned for improvements.

 

 

Syncing to a prototype via Sketch

With Craft Manager, we also introduced some changes to the Sketch publishing workflow via Craft Sync. The publish process is still triggered by the Craft Sync plugin, but the publish dialog itself is located in Craft Manager.

SELECTING ARTBOARDS IN SKETCH
By default, when you click the Sync plugin icon on the right hand side of Sketch, artboards that are currently selected will be published. To publish all artboards, click the Sync plugin icon with no artboards selected. View the number of artboards being published from within the publish dialog. 
 
PUBLISHING A NEW PROTOTYPE FROM SKETCH VIA CRAFT SYNC
After click the Sync plugin icon, you will see the Craft Manager publish modal.  If you have never published a prototype from the Sketch file before, you will be prompted to create a new prototype. If you want to update an existing prototype, click Sync existing prototypeWhen publishing a new prototype, you will be required to give it a name and select a device type. Clicking Publish will take you back to the prototypes tab where you can view the publish progress.
 
See 'Viewing sync progress from a Sketch file via Craft Sync' below for next steps.
 
 
UPDATING AN EXISTING PROTOTYPE FROM SKETCH VIA CRAFT SYNC
If you have published a prototype via the Sketch file before, when you click the Sync icon, you’ll be prompted to click Update to update your existing prototype . If you wish to publish an entirely new prototype, click the +" button to the right of your prototype name in the Sync modal, where you will be prompted to assign the new prototype a name and a device type.
 
Clicking Publish will take you back to the prototypes tab where you can view the publish progress.
 
 
VIEWING SYNC PROGRESS FROM A SKETCH FILE VIA CRAFT SYNC
After clicking Publish/Update you can view your publish progress in the prototypes tab of the Craft Manager modal. There are a few stages of the publish process that need to complete before your prototype is ready:
    • Exporting Assets - We export all layers marked as exportable so that they can easily be downloaded via Inspect.
    • Extracting Inspect Data - Inspect gives your developers access to all the important information they need when implementing a prototype. During the publish process, we need to extract all this information from the Sketch file. 
    • Uploading - Finally, once all data is ready, we upload it all the InVision. Upload times can vary depending on the size of the prototype and your internet speed. 
 
Once your prototype is published, we give you the prototype url which you can preview on InVision via the web or the InVision mobile app. 
 
STOPPING AN ACTIVE SYNC OF A SKETCH FILE VIA CRAFT SYNC
Stop an active sync by clicking the square in the sync progress icon. Artboards that have already successfully uploaded will remain in your prototype even if you stop the sync in mid-progress.
 

Syncing to a prototype via Photoshop 

The process for using Craft Sync for Photoshop differs from the description above for Craft Sync for Sketch. Note that first you’ll need to follow the set up instructions below for Photoshop, then you’ll be able to begin syncing using the following instructions.

 

Sync setup - Photoshop for Mac OS

For Macs, you’ll need Craft Manager in order to use the Craft plugins.

In Photoshop for Mac, click the Sync icon and enter your InVision login credentials, then click Sign in to InVision.

Sync Helper allows a secure login to your InVision prototypes. Click Continue when prompted to Allow Sync helper to open.

image-2017-04-13-13-30-02-288.png

A Mac dialog box appears to ask permission to allow the Sync Helper to run. Click Allow.

If you don’t yet have an InVision account, click Create Account, which will take you to the sign-up flow at InVisionApp.com. Once you complete signing up for an account, you can go back to Photoshop and login to the plugin with your new InVision credentials.

 

Sync Setup - Photoshop for Windows

For Windows, you’ll need to download the Craft Sync Windows Installer in order to use the Craft Sync plugin.

  1. Once you open the installer, click Yes to allow the app to make changes to your device.
  2. Click Install.
  3. Wait while Craft installs on your computer.

  4. Once the download is complete, click Finish.

  5. If Photoshop is already open on your machine, restart it.
  6. To open the plugin, in Photoshop go to Windows > Extensions > Sync (Beta). The first time you relaunch Photoshop, it may take up to one minute before the Sync displays in the panel.

  7. The first time you open the Sync plugin, you may receive a Windows Security Alert modal pop up. We recommend checking both private and public networks, then click Allow access.

Back in the Craft Sync panel in Photoshop, click Sign in to InVision. If you don’t yet have an InVision account, click Create Account, which will take you through the sign up flow at InVisionApp.com. Once you complete signing up for an account, you can go back to Sketch or Photoshop and login to the plugin with your new InVision credentials.

When an update to Craft Sync for Windows is available, you will see the modal below and need to click Update now. You will be required to update when a new version is available. Once you update, you’ll also need to restart Photoshop.

 

Syncing to a prototype via Photoshop

Once you’re logged in, you can start syncing your Photoshop screens to your InVision prototype(s).

Select which prototype you’d like to sync your screens to by choosing your prototype from the list, or use the search field to find it by name. 

To sync screens to a new prototype, click Create a new prototype, enter the new prototype name (you cannot use the name of a pre-existing prototype for a new prototype) and select which account you’d like it under, then click Create Prototype.

Sync-Create-a-new-prototype.png

When creating a new prototype, enter the prototype name, device type, and the account you'd like the new prototype under.

Screen_Shot_2017-05-22_at_8.30.09_AM.png

When choosing an existing prototype to sync to, you’ll see your unarchived prototypes from both personal and Enterprise accounts. You also have access to prototypes you’ve been given Contributor/Collaborator access.

If you have synced from the active document before, the plugin will default to the last prototype you synced to. You can change this at any time.

 

Selecting artboards and initiating a sync via Photoshop

The Sync plugin exports and uploads artboards from your design as screens in your InVision prototype. If you're working with a legacy Photoshop project, in order to use Craft Sync you'll need to convert your layer groups to artboards first. You can do this by left-clicking on a layer group in your non-artboard Photoshop file, then select the option to convert that layer group to an artboard.

You can either sync all artboards from a page or selected artboards. If you chose Only selected artboards, select which artboards you want to sync.

To exclude an artboard from syncing, you can place a minus sign (-) in front of the artboard name:

 

Screen_Shot_2017-06-26_at_8.17.52_AM.png

In Photoshop, you’ll also be able to select the export pixel density (1x or 2x) from the project selector screen.

Once you’ve selected your prototype and whether you’d like to sync all artboards on an active page or only selected artboards, click Sync to InVision. Your Photoshop document must exist on your hard drive (meaning it’s been saved at least once), for a sync to start. All screens sent to InVision with Craft Sync for Photoshop are compatible with Inspect. 

As your sync takes place, you’ll be able to view the progress under the sync button:

Once syncing is complete, you’ll see a green check mark, when your prototype was last synced, and an Open button to go directly to your prototype dashboard in InVision:

Note: The current build does not make a share link available. That functionality will be added in an upcoming release.

When syncing artboards from Photoshop via Craft Sync, screens are updated based on the artboard name matching the underlying filename for the screen in InVision. Screen replacement when renaming an artboard is not supported.

 

Stopping an active sync of a Photoshop file via Craft Sync

Stop an active sync by hovering over the sync circle progress indicator in the plugin’s footer and pressing the X icon. Artboards that have already successfully uploaded will remain in your prototype even if you stop the sync in mid-progress.

 

Changing your sync settings

Sketch settings

Use Craft Manager to adjust your Sketch settings for Craft Sync:

  1. Click the Craft Manager icon in your toolbar.
  2. Click the cogwheel, then click Preferences.
  3. Click Sync (next to General).
  4. From here, you can adjust the exported pixel density and notification sounds.

 

Photoshop settings

When using Craft Sync for Photoshop, click the cogwheel to log out of the account or send us feedback.

Select your export pixel density (1x or 2x) from the main Craft Sync screen.

Selecting a density will export the artboard at the selected density. If 2x is selected, a 500x500 artboard will be exported and uploaded at twice the size (1000x1000), but displayed in your prototype at 500x500. Alternatively, you can export at 1x.

Sketch’s density setting will up-res the image and Photoshop’s density setting just allows you to define at what density you designed the artboard. In Photoshop, by default the export density is 2x.

Known Limitations

  • Unsyncing: At this time, you can’t unsync. You can switch to a different prototype, but there is currently no way to unsync screens sent to a prototype. You would need to overwrite them manually or delete them in your InVision prototype dashboard.
  • SSO: Craft Sketch Sync supports SSO login and is available as an option after choosing Enterprise sign in and entering your InVision Enterprise domain name. While Craft Photoshop Sync does not presently support SSO, Enterprise users can still log into Craft Sync and use it successfully by providing native credentials. If you don't know your native password, you can do a password reset to generate a new one.
  • Sharing: The current build does not make a share link available directly from Craft Sync. That functionality will be added in an upcoming release.
  • Photoshop density: Sketch’s density setting will up-res the image and Photoshop’s density setting just allows you to define at what density you designed the artboard.
  • Assets: Craft Sync for Photoshop will generate assets for export from any layers with names ending in .png, .gif, or .jpg only.
  • Private Cloud: Enterprise accounts with Private Cloud enabled can log in with Craft Sketch Sync via SSO login. Native credentials are required to log in with Craft Photoshop Sync.