All Collections
Using Third-Party Git Providers
Using Sympli Versions with Bitbucket
Using Sympli Versions with Bitbucket

Connect Versions with Bitbucket

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

Signing up with a Bitbucket account

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

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

Connecting your Bitbucket 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 Bitbucket”.

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

Creating Bitbucket-stored project in 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 ~/Versions folder.

Select Bitbucket 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 the “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 Bitbucket

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.

We can't manage Bitbucket users from Sympli Versions, so you'll be redirected to Bitbucket, where you can invite users and select their access level (Read, Write, or Admin). 

All invited users will need to also link their Bitbucket account to be able to access the Bitbucket-stored Versions projects. They'll have the access level selected from Bittbucket.

Did this answer your question?