Skip to main content

Code Repository

This guide explains how you can access the Temenos Explorer source code repository, clone this to your local machine and create a branch in which to do your development.

Repository Access

The Temenos Explorer source code is managed in a BitBucket code repository which can be accessed from the Temenos network or via Temenos VPN. The repository name is Transact Middle Office.

Step 1: Clone Repository to Local Machine

You have options for cloning the repository to your local machine:

Using the VS Code GUI

  1. Create a folder on your local machine for the repository
  2. Select the "Source Control" panel
  3. Select "Clone Repository"
  4. Enter the Git URL for the BitBucket repository
  5. When prompted, select the folder from step 1 as the destination location on your local machine
  6. When prompted, enter your BitBucket username and password

The remote repository will then be cloned to your local machine which can take a few minutes depending on the speed of your connection

  1. When prompted, open the cloned repository

Using the Terminal

  1. Create a folder on your local machine for the repository
  2. Open the folder in Visual Studio Code
  3. Go to the terminal (select "Terminal -> New Terminal" from the file menu if no terminal is open)
  4. Run the command git clone <git link>
  5. When prompted, enter your BitBucket username and password

The remote repository will then be cloned to your local machine which can take a few minutes depending on the speed of your connection

Step 2: Create a Branch

If a branch has not already been created for you to work in, then you will need to create one.

You must never work directly in the root development default branch.

You have options for creating a new branch:

Using the Web Interface

You can create a branch using the BitBucket web interface by clicking on the "Create Branch" button in the toolbar on the left and using these details:

FieldDetails
Branch typeChoose an appropriate branch type, e.g. "Feature" if adding a new plugin, or "Bugfix" if addressing an issue with an existing plugin.
Branch fromChoose development
Branch nameEnter a short, unique and descriptive name for your branch

Using the VS Code GUI

  1. Click on the checked out branch in the bottom left corner of the Visual Studio Code window (this should show "development" if you have not changed branches after cloning the repository)
  2. In the task panel that opens click "Create new branch"
  3. When prompted, enter a short, unique and descriptive name for your branch

Using the Terminal

  1. Go to the terminal (select "Terminal -> New Terminal" from the file menu if no terminal is open)
  2. Run the command git checkout -b ${branchName} development where ${branchName} is the name of your new branch

Step 3: Select a Branch

You must ensure your branch is selected before you start work.

You have options for selecting the branch:

Using the VS Code GUI

  1. Click on the checked out branch in the bottom left corner of the Visual Studio Code window (this should show "development" if you have not changed branches after cloning the repository)
  2. In the task panel that opens choose your branch from the list

Using the Terminal

Run the command git checkout ${branchName} where ${branchName} is the name of your branch