{"id":13994374,"url":"https://github.com/osowskit/atlassian-github-app-addon","last_synced_at":"2025-07-22T19:32:01.141Z","repository":{"id":52523121,"uuid":"93896045","full_name":"osowskit/atlassian-github-app-addon","owner":"osowskit","description":"Add a branch to GitHub from JIRA","archived":false,"fork":false,"pushed_at":"2023-05-16T03:38:36.000Z","size":90,"stargazers_count":27,"open_issues_count":5,"forks_count":11,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-10T14:16:03.456Z","etag":null,"topics":["atlassian","github-app","jira","jira-tickets","ruby"],"latest_commit_sha":null,"homepage":"https://marketplace.atlassian.com/apps/1217260/create-github-branches-from-jira?hosting=cloud\u0026tab=overview","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/osowskit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-06-09T20:53:10.000Z","updated_at":"2023-05-25T17:48:04.000Z","dependencies_parsed_at":"2024-01-18T04:54:34.604Z","dependency_job_id":"d90eeb67-18d4-4ef2-bbf7-5266dbca3cf6","html_url":"https://github.com/osowskit/atlassian-github-app-addon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osowskit%2Fatlassian-github-app-addon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osowskit%2Fatlassian-github-app-addon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osowskit%2Fatlassian-github-app-addon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osowskit%2Fatlassian-github-app-addon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osowskit","download_url":"https://codeload.github.com/osowskit/atlassian-github-app-addon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227166697,"owners_count":17740963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atlassian","github-app","jira","jira-tickets","ruby"],"created_at":"2024-08-09T14:02:50.342Z","updated_at":"2024-11-29T16:31:18.453Z","avatar_url":"https://github.com/osowskit.png","language":"Ruby","readme":"# Create GitHub Branches from Jira\n\n## Usage\n\nThis [Atlassian Marketplace add-on](https://marketplace.atlassian.com/plugins/com.osowskit.jira.github.app/cloud/overview) provides the convenience of creating branches in GitHub from a JIRA ticket. Create and view GitHub branches directly from a JIRA issue.\n\n* Install the add-on : https://marketplace.atlassian.com/1217260\n\n\u003cimg width=\"738\" alt=\"Screen Shot 2023-05-15 at 8 15 56 PM\" src=\"https://github.com/osowskit/atlassian-github-app-addon/assets/768821/4cf31f58-f69b-4344-9279-03e6865fc722\"\u003e\n\n* Simply add the GitHub App to your account : https://github.com/apps/jira-bot and select which repositories you want to create branches in\n\n* Navigate to any ticket on your JIRA instance an click the `Connect to GitHub` link \n\n\u003cimg src=\"https://user-images.githubusercontent.com/768821/34046355-9bff2df6-e161-11e7-9c6f-a1ec03b84a28.png\" width=\"250\"\u003e\n\n* Create and view branches in a JIRA ticket.\n\n* View any Pull Request for the branch\n\n\u003cimg src=\"https://user-images.githubusercontent.com/768821/32191639-0bb9e878-bd6f-11e7-9fb2-7b85b5f0328b.png\" width=\"350\"\u003e\n\n## Custom Branch Names\n\nThe default branch pattern will use the issue key as the branch name and create this off of the main default branch. It is possible to set a GitFlow branching pattern and also use a custom branch name as outlined below.\n\n### Custom Branch Name\n\nUsers can choose to manually enter the branch name by using a per Repository config file. This allows the user to add custom text as the branch name and be created off of the main default branch, e.g. `SENG-1234/my-great-feature`. Set this for each repository using this pattern:\n\n1. Add the following file `.github/jira-bot.yaml` to the main default branch\n1. Set the file contents to be `branch_pattern: 2`\n1. In Jira, with the plugin loaded, remove and re-add each repository that has been updated. (The branch pattern is cached and needs to be refreshed).\n\n\u003cimg width=\"224\" alt=\"Screen Shot 2023-05-15 at 8 24 49 PM\" src=\"https://github.com/osowskit/atlassian-github-app-addon/assets/768821/d818d9c5-4d0b-4763-94ec-4df49714337c\"\u003e\n\n### GitFlow\n\nUsers can select the GitFlow branching pattern in the config file that will create a feature branch off of the `develop` branch, e.g. `feature/SENG-1234`. For each repository, use this pattern:\n\n1. Add the following file `.github/jira-bot.yaml` to the Repository's default branch\n1. Set the file contents to be `branch_pattern: 1`\n1. In Jira with the plugin loaded, remove and re-add each repository that has been updated. (The branch pattern is cached and needs to be refreshed).\n\n### GitFlow + Custom Branch Name (deprecated)\n\nUsers can select the GitFlow branching pattern in the config file that will create a feature branch off of the `develop` branch, e.g. `feature/SENG-1234`. This option allows users to also set the branch name via the UI. This setting is deprecated and users should set `branch_pattern: 3` and `default_base_branch_name: 'develop'` going forward.\n\nFor each repository, use this pattern:\n\n1. Add the following file `.github/jira-bot.yaml` to the Repository's default branch\n1. Set the file contents to be `branch_pattern: 3`\n1. In Jira with the plugin loaded, remove and re-add each repository that has been updated. (The branch pattern is cached and needs to be refreshed).\n\n### Custom Base Branch\n\nTeams that have branching patterns that are created off a branch that isn't the Repository's default branch. The following configuration allows users to set the base branch where new branches are created from. \n\nFor each repository, use this pattern:\n\n1. Add the following file `.github/jira-bot.yaml` to the Repository's default branch\n1. Set the file contents to be `default_base_branch_name: 'dev'`\n1. In Jira with the plugin loaded, remove and re-add each repository that has been updated. (The branch pattern is cached and needs to be refreshed).\n\nHere is the approved branch name list. Please open an issue to request a new branch\n```\n['master', 'main', 'development', 'dev', 'feature', 'hotfix', 'release', 'test', 'testing']\n```\n\n[Example yaml file](https://github.com/osowskit/an-repo/blob/master/.github/jira-bot.yaml)\n","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosowskit%2Fatlassian-github-app-addon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosowskit%2Fatlassian-github-app-addon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosowskit%2Fatlassian-github-app-addon/lists"}