1. Abstract
  2. Using Abstract
  3. Working in Projects

Create a branch

Follow

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.

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. 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 Main from the left side pane

  4. Select the file you’d like to edit

  5. Select Edit in Sketch 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 opens in Sketch. 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. From the ... menu in the top right corner select New Child Branch
  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 opens in Sketch. 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 Main 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: