# nvie/gitflow architecture

> Architecture diagram of the GitHub repository nvie/gitflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nvie/gitflow
- Repository: https://github.com/nvie/gitflow

## Overview

git-flow is a shell-based collection of Git extensions for branch operations. The documented workflow starts with `git flow init`, then uses feature, release, hotfix, or support commands to manage branches; feature branches also support publish and pull. The tree identifies corresponding command scripts, but no source excerpts were provided, so internal dispatch and helper usage cannot be verified. Edges below reflect the documented command interface rather than inspected implementation calls.

Main entry points: [`git-flow`](https://github.com/nvie/gitflow/blob/develop/git-flow) (git-flow CLI), [`git-flow-init`](https://github.com/nvie/gitflow/blob/develop/git-flow-init) (Initialize), [`git-flow-feature`](https://github.com/nvie/gitflow/blob/develop/git-flow-feature) (Feature branches), [`git-flow-release`](https://github.com/nvie/gitflow/blob/develop/git-flow-release) (Release branches)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Command interface"]
  node_cli["git-flow CLI"]
end

subgraph group_branches["Branch workflows"]
  node_init["Initialize"]
  node_feature["Feature branches"]
  node_release["Release branches"]
  node_hotfix["Hotfix branches"]
  node_support["Support branches"]
end

subgraph group_shared["Shared support"]
  node_common["Common helpers"]
end

node_user(("Git user"))

node_user -->|"runs commands"| node_cli
node_cli -->|"offers init"| node_init
node_cli -->|"offers feature"| node_feature
node_cli -->|"offers release"| node_release
node_cli -->|"offers hotfix"| node_hotfix
node_cli -->|"offers support"| node_support

click node_cli "https://github.com/nvie/gitflow/blob/develop/git-flow"
click node_init "https://github.com/nvie/gitflow/blob/develop/git-flow-init"
click node_feature "https://github.com/nvie/gitflow/blob/develop/git-flow-feature"
click node_release "https://github.com/nvie/gitflow/blob/develop/git-flow-release"
click node_hotfix "https://github.com/nvie/gitflow/blob/develop/git-flow-hotfix"
click node_support "https://github.com/nvie/gitflow/blob/develop/git-flow-support"
click node_common "https://github.com/nvie/gitflow/blob/develop/gitflow-common"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_user toneBlue
class node_init,node_feature,node_release,node_hotfix,node_support toneAmber
class node_common toneMint
```

## Components

### Command interface

- [git-flow CLI](https://github.com/nvie/gitflow/blob/develop/git-flow): `git-flow`

### Branch workflows

- [Initialize](https://github.com/nvie/gitflow/blob/develop/git-flow-init): `git-flow-init`
- [Feature branches](https://github.com/nvie/gitflow/blob/develop/git-flow-feature): `git-flow-feature`
- [Release branches](https://github.com/nvie/gitflow/blob/develop/git-flow-release): `git-flow-release`
- [Hotfix branches](https://github.com/nvie/gitflow/blob/develop/git-flow-hotfix): `git-flow-hotfix`
- [Support branches](https://github.com/nvie/gitflow/blob/develop/git-flow-support): `git-flow-support`

### Shared support

- [Common helpers](https://github.com/nvie/gitflow/blob/develop/gitflow-common): `gitflow-common`

### Other components

- **Git user**

## Connections

- Git user → git-flow CLI: runs commands (evidence: `README.mdown`)
- git-flow CLI → Initialize: offers init (evidence: `README.mdown`)
- git-flow CLI → Feature branches: offers feature (evidence: `README.mdown`)
- git-flow CLI → Release branches: offers release (evidence: `README.mdown`)
- git-flow CLI → Hotfix branches: offers hotfix (evidence: `README.mdown`)
- git-flow CLI → Support branches: offers support (evidence: `README.mdown`)
