Skip to main content

Git & Versioning Workflow

The canonical standard, as an interactive, animated walkthrough — single-trunk develop, releases as immutable tags, environment promotion, and how CORE · MODULES · APPS stay wired together. Switch the view tabs (Branch · Deploy · Integrate) and press play.

The model in one paragraph​

One long-lived branch: develop (there is no main); it always holds shippable code. Every release is an immutable SemVer tag on develop. Short-lived feature/ · bugfix/ · hotfix/ · release/ branches handle each Jira issue; support/<x.y> lines patch old versions cut from an old tag. No back-merge. One string = git tag = version.yml = image tag (no v prefix).

  • Branch & release → the everyday flow, cutting a release, hotfix, and support branches.
  • Deploy & promote → build once, promote the exact digest Dev → Staging → Prod (+ Beta). See Build & Deploy.
  • Integrate → how an app fetches the core and modules, and how a module tag triggers the app's CI/CD. See Project Architecture.