Creating branches

Create a branch

In Abstract, new work starts by creating a branch. You can think of a branch as your working copy of the main branch—what we call the files that act as the source of truth for a project’s finalized designs. A branch is where you can safely explore and edit designs in a project before sharing them with your team through committing.

Versions-Create-Branch.png

You can create a branch from the main branch or from another branch. When you create a branch from another branch, we call the original branch the “parent branch” and the new branch the “child branch”. You may choose to branch from a parent branch if you’d like to pick up where someone else left off in their branch.

Creating a branch does not affect the main branch. You’ll commit your changes and go through a review process before you merge any changes to the main branch.

Create a branch from the main branch

To create a branch from the main branch:

  1. Open the Abstract desktop app.

  2. Select the project you’d like to edit.

  3. Select Master from the left side pane.

  4. Select the file you’d like to edit.

  5. Select EDIT IN SKETCH or EDIT IN ADOBE XD in the top right.

  6. Select Create a Branch.

  7. Enter a branch name that describes the edits you’re planning to make in that branch (e.g. Green version of iOS logo).

If your branch focus changes, you can edit the branch name.

  1. Select Create branch.

Your new branch will open in Sketch or Adobe XD. You can make edits and commit them right away.

Create a branch from another branch

To create a child branch from a parent branch:

  1. Open the Abstract desktop app.
  2. Select the project you’d like to edit.
  3. Select Branches from the left side pane.
  4. Select the branch you’d like to branch from.
  5. Click NEW BRANCH in the top right corner.
  6. Enter a branch name that describes the edits you’re planning to make in that branch (e.g. Green version of iOS logo).
  7. Select Create branch.

Your new branch will open in Sketch or Adobe XD. You can make edits and commit them right away.

Create a branch from a commit

To use a previous commit on the main branch or on another branch as the starting point for your new branch:

  1. Open the Abstract desktop app.
  2. Select the project you’d like to edit.
  3. Select Master or a branch from the left side pane.
  4. Select the Commits tab at the top of the page.
  5. Right-click the commit you want to branch from and select Create branch...
  6. Enter a branch name that describes the edits you’re planning to make in that branch.
  7. Select Create branch.

Branch permissions

When you create a branch, you become the branch owner. As branch owner, you can: