Configuration Options

Git Board Flow provides extensive configuration options to customize your workflow. Below you'll find detailed information about each configuration option available.

Authentication

• token: GitHub token for repository operations (required)
• openai-api-key: OpenAI API key for AI operations (optional)

Branch Management

• branch-management-launcher-label: Label to trigger branch management (default: "branched")
• branch-management-always: Ignore launcher label requirement (default: "false")
• branch-management-emoji: Emoji for branched issues (default: "🧑‍💻")

Branch Types and Labels

• main-branch: Main branch name (default: "master")
• development-branch: Development branch name (default: "develop")
• feature-tree: Feature branch prefix (default: "feature")
• bugfix-tree: Bugfix branch prefix (default: "bugfix")
• hotfix-tree: Hotfix branch prefix (default: "hotfix")
• release-tree: Release branch prefix (default: "release")
• docs-tree: Documentation branch prefix (default: "docs")
• chore-tree: Chore branch prefix (default: "chore")

Issue Labels

• feature-label: Feature branch label (default: "feature")
• bugfix-label: Bugfix branch label (default: "bugfix")
• hotfix-label: Hotfix branch label (default: "hotfix")
• release-label: Release branch label (default: "release")
• docs-label: Documentation label (default: "docs")
• documentation-label: Alternative documentation label (default: "documentation")
• chore-label: Chore label (default: "chore")
• maintenance-label: Maintenance label (default: "maintenance")
• bug-label: Bug type label (default: "bug")
• enhancement-label: Enhancement type label (default: "enhancement")
• question-label: Question label (default: "question")
• help-label: Help request label (default: "help")
• deploy-label: Deploy action label (default: "deploy")
• deployed-label: Deployed status label (default: "deployed")

Size Labels and Thresholds

Size Labels

• size-xxl-label: XXL size label (default: "size xxl")
• size-xl-label: XL size label (default: "size xl")
• size-l-label: L size label (default: "size l")
• size-m-label: M size label (default: "size m")
• size-s-label: S size label (default: "size s")
• size-xs-label: XS size label (default: "size xs")

Size Thresholds

Each size has three threshold parameters:

• size-{size}-threshold-lines: Number of lines threshold
• size-{size}-threshold-files: Number of files threshold
• size-{size}-threshold-commits: Number of commits threshold

Default thresholds:

• XXL: 1000 lines, 20 files, 10 commits
• XL: 500 lines, 10 files, 5 commits
• L: 250 lines, 5 files, 3 commits
• M: 100 lines, 3 files, 2 commits
• S: 50 lines, 2 files, 1 commit
• XS: 25 lines, 1 file, 1 commit

Project Integration

• project-urls: Comma-separated list of GitHub Project URLs to link issues and PRs
• desired-assignees-count: Number of assignees for issues/PRs (default: 1, max: 10)
• desired-reviewers-count: Number of reviewers for PRs (default: 1, max: 15)

Customization

• emoji-labeled-title: Enable emoji titles based on labels (default: "true")
• commit-prefix-builder: Custom commit prefix generation logic
• reopen-issue-on-push: Reopen closed issues on new commits (default: "true")
• merge-timeout: Timeout for merge operations in seconds (default: 600)

Workflow Files

• release-workflow: Release workflow filename (default: "release_workflow.yml")
• hotfix-workflow: Hotfix workflow filename (default: "hotfix_workflow.yml")

Single Actions

• single-action: Launch single actions
• single-action-issue: Issue target for executing single action

Image Configuration

Image Display Settings

• images-on-issue: Enable images in issue comments (default: "true")
• images-on-pull-request: Enable images in PR comments (default: "true")
• images-on-commit: Enable images in commit comments (default: "true")

Issue Images

• images-issue-automatic: Image URLs for automatic action issue comments
• images-issue-feature: Image URLs for feature action issue comments
• images-issue-bugfix: Image URLs for bugfix action issue comments
• images-issue-docs: Image URLs for docs action issue comments
• images-issue-chore: Image URLs for chore action issue comments
• images-issue-hotfix: Image URLs for hotfix action issue comments
• images-issue-release: Image URLs for release action issue comments

Pull Request Images

• images-pull-request-automatic: Image URLs for automatic action PR comments
• images-pull-request-feature: Image URLs for feature action PR comments
• images-pull-request-bugfix: Image URLs for bugfix action PR comments
• images-pull-request-docs: Image URLs for docs action PR comments
• images-pull-request-chore: Image URLs for chore action PR comments
• images-pull-request-hotfix: Image URLs for hotfix action PR comments
• images-pull-request-release: Image URLs for release action PR comments

Commit Images

• images-commit-automatic: Image URLs for automatic action commit comments
• images-commit-feature: Image URLs for feature action commit comments
• images-commit-bugfix: Image URLs for bugfix action commit comments
• images-commit-docs: Image URLs for docs action commit comments
• images-commit-chore: Image URLs for chore action commit comments
• images-commit-hotfix: Image URLs for hotfix action commit comments
• images-commit-release: Image URLs for release action commit comments

AI Features

• ai-pull-request-description: Enable AI-powered automatic updates for pull request descriptions (default: "false")
• ai-ignore-files: Comma-separated list of files to ignore for AI operations
• ai-members-only: Restrict AI features to only organization/project members (default: "true")