Workflows

Branqo includes workflow presets for common Git branching strategies and supports custom workflow automation.

Built-in Presets

GitFlow

The classic GitFlow workflow with main, develop, feature/*, release/*, and hotfix/* branches:

1. Go to Settings → Workflows
2. Select GitFlow preset
3. Branqo enforces the branching rules automatically:
   • Features branch from develop
   • Releases branch from develop, merge to both main and develop
   • Hotfixes branch from main, merge to both main and develop

GitHub Flow

A simplified workflow with main and short-lived feature branches:

1. Select GitHub Flow preset
2. All feature branches are created from main
3. Features are merged back to main via pull request

Trunk-Based Development

Direct commits to main with optional short-lived feature flags:

1. Select Trunk-Based preset
2. Encourages small, frequent commits directly to main
3. Feature branches are limited to 1-2 days

Custom Workflows (Premium)

Create your own automated multi-step workflows:

1. Go to Settings → Workflows → Custom
2. Click Create Workflow
3. Define the steps using a YAML-like editor:

name: "Feature Complete"
trigger: manual
steps:
  - fetch: { remote: origin }
  - checkout: { branch: develop }
  - pull: { remote: origin, branch: develop }
  - merge: { branch: "{{current_branch}}" }
  - push: { remote: origin, branch: develop }
  - branch-delete: { branch: "{{current_branch}}" }

Workflow Variables

• {{current_branch}} — The branch that was active when the workflow started
• {{repo_name}} — The repository name
• {{remote_url}} — The primary remote URL

Running Workflows

• Click the Workflow button in the toolbar
• Select a workflow from the list
• Click Run
• Branqo executes each step in sequence, stopping if any step fails

CLI

# Run a workflow
branqo workflow run "Feature Complete"

# List available workflows
branqo workflow --list

# Run with JSON output
branqo --json workflow run "Feature Complete"