Using Sympli Versions with Gitlab

Connect Versions with Gitlab

Maria Merkulova avatar
Written by Maria Merkulova
Updated over a week ago

Signing up with a Gitlab account

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

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

Connecting your Gitlab account to an existing Sympli Versions account

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

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

Creating Gitlab-stored project in Sympli Versions

Projects in Versions look and feel like a regular folder, while 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 ~/Sympli 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?