Signing up with a Gitlab account

After you install and run Versions desktop application, then choose Gitlab as a Sign In option.

You will be redirected to Gitlab to authorize Versions application to access your account.

Connecting your Gitlab account to an existing Versions account

In case you already have a Versions account, go to your Account Settings and click “Sign in with Gitlab”.

You will be redirected to Gitlab to authorize Versions application to access your account, and your Gitlab account will be linked to your Versions account.

Creating Gitlab-stored project in Versions

Projects in Versions look and feel as a regular folder, while on under the hood it’s connected to an actual version control system.

To create a project, in a new project dialog fill in the name of the project. By default, your projects will be stored in your ~/Versions folder.

Select Gitlab as a service to store your files at, and choose a team (if any) to own the project. 

Working with projects

To start working with the project, open a working directory with “Reveal in Finder” option from the kebab menu on a project card.

Then, move your Sketch mockups to the working folder. Once you do that, you’ll notice that files now have status indicators, which are described below.

File statuses

Publishing updates to Gitlab

First, you need to make sure your files are tracked. To do so, select a file with ? status in Finder, and in the context menu select “Add File”.

Then, provide some context on what this mockup is for or what you were working on and hit “Upload Files”.

Congratulations! Your mockup is now published, so you can collaborate on it with your team.

Sharing with your Team

Open "Members" tab in the project’s dashboard, and then click on “Manage in Web App”. At the moment, team management is only available there.

In the web app, you can invite new team members via email and set their access level (Read-only, Write or Admin) using “Share Project” button:

Did this answer your question?