Pull Request Badge lets you programatically insert badges in your pull request descriptions and then link them to anything. Like this one 👇
After installation, Pull Request Badge will receive a webhook event whenever a Pull Request is opened or edited. Based on the configuration file in your repository, badges that match criteria will be inserted at the beginning of the Pull Request description.
I initially created Pull Request Badge to deal with JIRA links, but it can easily present any kind of information through the simple and flexible API. For example: how about adding a preview badge with a link to a preview instance? Or indicate if the Pull Request is rather large? Check out the $payload attribute for more details. Your creativity is the limit.
Hello there! I'm Stefan 👋 I care a lot about efficiency and that's the reason I built a browser extension that allows you to navigate through code on GitHub much more efficiently. OctoLinker is trusted by over 25,000 developers. Read the story behind Pull Request Badge on my blog.
This is just the beginning! I have plenty other ideas on how to make your developer experience much better. Sign up to be the first to hear about other tools I'm working on.
»With a large distributed engineering team, it can be hard to enforce rules about including links to tickets withinPull Requests; having it automated was the perfect solution and it’s super slick.«
.github/pr-badge.yml
file in your repository with the following content.- label: "JIRA" message: "$issuePrefix" color: "#0052CC" url: "https://jira.company.com/browse/$issuePrefix" when: "$issuePrefix"
Text on the left side of the badge.
Text on the right side of the badge.
If added, the badge will be wrapped with this URL.
The color for the badge. The default value is #0052CC
The URL of the image.
JavaScript code that must be an expression (something which evaluates to a boolean). Exampe: $additions > 200
- label: "Preview" message: "PR $prNumber" color: "blue" url: "https://pr-$prNumber.company.com"
»As engineers we use GitHub heavily every day. We just as often need to interface with other systems or resources such as Atlassian Jira or deployment previews. Pull Request Badge helps us bridging the gaps and linking to anything external becomes a breeze.«
Raw webhook payload object from GitHub. Check out the webhook payload example for further information.
The number of this Pull Request.
Shorthand for: $payload.pull_request.number
The name of the branch where your changes are implemented.
Shorthand for: $payload.pull_request.head.ref
The branch name or Pull Request title issue prefix extracted when following the Naming Convention.
Name of the Pull Request author.
Shorthand for: $payload.pull_request.user.login
Indicates whether this Pull Request is a draft.
Shorthand for: $payload.pull_request.draft
The number of additions made in this Pull Request
Shorthand for: $payload.pull_request.additions
The number of deletions made in this Pull Request
Shorthand for: $payload.pull_request.deletions
Total number of commits
Shorthand for: $payload.pull_request.commits
Total number of changed files
Shorthand for: $payload.pull_request.changed_files
Pull Request Badge uses the following naming convention to extract the $issuePrefix
. Please make sure your branch name or Pull Request title contains an uppercase issuePrefix.
ABC-123
ABC-123
-better-accessibilityABC-123
ABC-123
-better-accessibilityABC-123
ABC-123
Better accessibilityABC-123
ABC-123
Better accessibility»With the Pull Request Badge App developers have everything they need to move forward and this helps us to make our communication much more effective.«
No, not yet. The source code is exclusively available to people who sponsor me on GitHub, but after reaching a certain number of sponsors, the software fully open-source and available to anyone.
Sponsorware means building and releasing a project exclusively to people who sponsor me on GitHub, but after reaching a certain number of sponsors, make the package fully open-source and available to anyone. Head over to github.com/stefanbuck/pull-request-badge-app to learn more about it.
Yes, we do. Become a sponsorware "customer" and you will get a Pro plan with unltimed private repositories.
Become a sponsorware "customer" and you will get access to the source code which then allows you to run the app yourself. Reach out to us, if you any questions.
We only request necessary GitHub permission and we canot read or write any source code! The Pull Request App requires the following GitHub Permissions:
.github/pr-badge.yml