Branch Strategy

Repos: flow-platform and flow-mobile

Branches

BranchPurpose
mainProduction — always deployable. Requires 1 approval + CI.
developStaging buffer. Requires CI.
feature/<name>New features — cut from develop, PR to develop
fix/<name>Bug fixes — cut from develop, PR to develop
hotfix/<name>Urgent fix — cut from main, PR to main, then back-merge to develop
chore/<name>Deps, config, tooling

Normal flow

feature/* or fix/* → develop → main

Hotfix flow

  1. Cut hotfix/<name> from main
  2. PR to main (1 approval + CI required)
  3. After merge: open back-merge PR from maindevelop

Repo: flow-docs

Only main and short-lived docs/<name> branches. PRs go directly to main.