Skip to main content

Overview

Branches let you work on different features or experiments without affecting your main codebase. VibeHub provides Git-like branching with an intuitive visual interface.

Why Use Branches?

  • Isolate work - Develop features without affecting stable code
  • Collaborate safely - Multiple people can work on different branches
  • Experiment freely - Try ideas without risk to your main branch
  • Review before merging - Compare and approve changes before they go live

The Branch Selector

The branch selector dropdown appears in your project header. It shows:
  • Current branch name
  • List of all branches
  • Option to create new branches

Branch Indicators

IconMeaning
StarDefault branch (usually main)
ShieldProtected branch
CheckCurrently selected branch

Creating a Branch

1

Open Branch Selector

Click on the branch dropdown in your project header
2

Enter Branch Name

Type a name for your new branch in the input field at the bottom
3

Create

Click Create Branch or press Enter
Your new branch is created from the current branch’s latest commit (HEAD).

Branch Naming Tips

Use descriptive, lowercase names with hyphens. Include prefixes to categorize:
  • feature/user-auth
  • fix/login-bug
  • experiment/new-ui

Switching Branches

Click on any branch name in the dropdown to switch to it. When you switch:
  • The file browser updates to show that branch’s files
  • The commit history shows that branch’s commits
  • Any new commits you push will go to this branch

The Default Branch

Every project has a default branch (typically main). This is:
  • The branch shown when someone first opens your project
  • Usually represents production-ready code
  • Cannot be deleted
  • Often protected from direct pushes

Changing the Default Branch

  1. Go to project Settings
  2. Find branch management section
  3. Select a new default branch
Changing the default branch affects how others see your project. Make sure the new default contains stable code.

Protected Branches

Protected branches have extra safeguards:
  • Cannot be deleted
  • May require reviews before merging
  • Indicated with a shield icon

Deleting a Branch

1

Open Branch Selector

Click on the branch dropdown
2

Find the Branch

Locate the branch you want to delete
3

Delete

Click the trash icon next to the branch name
4

Confirm

Confirm the deletion when prompted
Deleting a branch removes all commits that exist only on that branch. This cannot be undone.

Branches You Can’t Delete

  • The default branch
  • Protected branches
  • The currently selected branch (switch first)

Branch Workflow Example

Here’s a typical workflow using branches:
  1. Start on main with stable code
  2. Create feature/login branch
  3. Make commits on the feature branch
  4. Meanwhile, main might get other updates
  5. When ready, merge feature/login into main
  6. Delete the feature branch (optional)

Next Steps