Skip to content
git-branch

GitHub Action

Git Board Flow

v1.0.11 Latest version

Git Board Flow

git-branch

Git Board Flow

Automates branch management, GitHub project linking, and issue/PR tracking with Git-Flow methodology

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Git Board Flow

              
  uses: landamessenger/[email protected]
Learn more about this action in landamessenger/git-board-flow

Choose a version

Git Board Flow: Automated Branch and Project Management GitHub Action

Git Board Flow is a powerful GitHub Action designed to streamline issue, branch, and project management while adhering to the Git-Flow methodology. This action simplifies your workflow by automating the creation and management of branches, linking them to issues, and ensuring smooth integration with GitHub Projects.

Key Features

1. Automatic Branch Creation

  • Detects when an issue is created or updated.
  • Analyzes issue labels (or configuration defined in your workflow) to determine the necessary branches:
  • Feature, Bugfix, Hotfix, Release, etc., following Git-Flow standards.
  • Automatically creates branches and links them to the issue.
  • Adds a summary comment to the issue describing the actions taken.

2. Commit Monitoring

  • Detects commits in branches linked to an issue.
  • Posts updates in the issue with a summary of the commits, including:
  • Commit messages.
  • Branch names.
  • Links to the commit history.

3. Pull Request Linking

  • Detects new PRs from branches linked to an issue.
  • Automatically links the PR to the corresponding issue.
  • Posts a comment in the PR summarizing its linkage and actions.

4. GitHub Project Integration

  • Seamlessly links issues and PRs to the specified GitHub Projects.
  • Ensures that all relevant entities are included in the right projects automatically.

5. Efficiency

  • Runs on Ubuntu and completes tasks in under 20 seconds, making it cost-effective and efficient for any repository.

Use Cases

  • Team Collaboration: Keep issues, branches, and PRs connected effortlessly for better visibility.
  • Automated Workflows: Reduce manual overhead with automated branch management and notifications.
  • Git-Flow Compliance: Maintain Git-Flow structure without additional effort.

Issues Management

name: Git Board Flow - Issue

on:
  issues:
    types: [opened, edited, labeled, unlabeled]

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  git-board-flow-issues:
    name: Git Board Flow - Issues
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Git Board Flow - Issues
        uses: landamessenger/git-board-flow@master
        with:
          action: issue
          project-urls: https://github.com/orgs/landamessenger/projects/2, https://github.com/orgs/landamessenger/projects/3
          commit-prefix-builder: |
            branchName.replace("/", "-");
          github-token: ${{ secrets.GITHUB_TOKEN }}
          github-token-personal: ${{ secrets.REPO_PAT }}

Pull Request Management

name: Git Board Flow - Pull Requests

on:
  pull_request:
    types: [opened, edited, labeled, unlabeled]

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  git-board-flow-pull-requests:
    name: Git Board Flow - Pull Requests
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Git Board Flow - Pull Requests
        uses: landamessenger/git-board-flow@master
        with:
          action: pull-request
          project-urls: https://github.com/orgs/landamessenger/projects/2, https://github.com/orgs/landamessenger/projects/3
          commit-prefix-builder: |
            branchName.replace("/", "-");
          github-token: ${{ secrets.GITHUB_TOKEN }}
          github-token-personal: ${{ secrets.REPO_PAT }}

Commits Check

name: Git Board Flow - Commits

on:
  push:
    branches:
      - '**'

jobs:
  git-board-flow-commits:
    name: Git Board Flow - Commits
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Git Board Flow - Commits
        uses: landamessenger/git-board-flow@master
        with:
          action: commit
          github-token: ${{ secrets.GITHUB_TOKEN }}
          github-token-personal: ${{ secrets.REPO_PAT }}
          commit-prefix-builder: |
            branchName.replace("/", "-");
  • Warning received if the prefix of the commit does not match the one defined from commit-prefix-builder.

Why Git Board Flow?

  • Consistent Git-Flow Management: Adheres strictly to Git-Flow methodology for clear branching strategies.
  • Project Visibility: Ensures all relevant branches, issues, and PRs are properly tracked and communicated.
  • Time-Saving: Automates repetitive tasks, freeing up time for development and review.
  • Affordable: Fast execution keeps costs low, even in large repositories.

Get started with Git Board Flow and simplify your GitHub project workflows today! 🚀