Branch per Environment

Applies to: FlexLab

Overview

FlexLab maps one Git branch per environment (e.g. main → production, develop → dev).

Steps — view mapping

1. Open /dashboard/[orgId]/project/[id]/environments.
2. Each card shows linked branch name (flexlabBranch).
3. Open Code to see branch list in GitLab.

Steps — add environment + branch

1. Create environment in dashboard (Add environment).
2. Platform creates or links a Git branch.
3. Push commits to that branch; pipeline deploys to the environment.

Workflow tips

• Never force-push shared production branches without coordination.
• Use merge requests for review before merging to production branch.
• Sync database/content via flexsite sync or dashboard sync when appropriate.

Branch renames require GitLab and dashboard alignment — contact Support on ACTIVE plans if stuck.