GitHub

Raise issues directly on GitHub repos with detailed bug reports.

BetterBugs integration with GitHub

BetterBugs and GitHub integration enable you to raise issues directly to your GitHub repo as GitHub issues. You can create a visual bug report with all the details you need to highlight to share the issue with your teammates and raise the issue directly on your GitHub repo.

Steps to integrate BetterBugs with GitHub

BetterBugs Integration with GitHub

1

Install extension

Install the extension and pin it to the browser for quick access.

2

Capture the bug

Take a screenshot, record a video, or hit Rewind (if it's already enabled for the website).

3

Enter bug details

Add a title* (Required) and other bug details about the bug.

4

Connect with GitHub

Open the "Send to your tools" dropdown from the top right corner of your screen. Click on "Authorize BetterBugs" to connect with your GitHub account.

5

Choose the BetterBugs workspace and project to connect

Below the "Send to your tools" dropdown, select the BetterBugs Workspace and Project to connect with GitHub.

• Dropdown 1: User's Workspace (default: BetterBugs Workspace Name)

• Dropdown 2: User's Project (default: BetterBugs Project Name)

NOTE: The integration will happen to the specific project you selected within BetterBugs. This means that if you have multiple projects, you'll need to set up separate integrations for each one. You can also integrate your entire workspace with the tool.

6

Enter details for GitHub

Click on the "Send to your tools" dropdown and select "GitHub issue".

This fetches the available GitHub repository names for "Your GitHub issue info". Select the GitHub repository and add details, such as Assignees, Labels, and Due date.

7

Send Report

Hit the "Upload Bug Details" button from down below.

That's it.

A new tab with the created GitHub Task opens up, posting the Issue to the selected GitHub repository, with all the details and a link to the complete bug report with developer tools info. You can access the complete bug report on the BetterBugs Dashboard with all the information.

You have successfully integrated GitHub with BetterBugs.

To check if the integration worked correctly and the report was shared with your GitHub repo,

1. Open the report that you just shared (using the Issue report link from the GitHub task or your BetterBugs project).

2. Click on the Comments/Activities tab at the bottom right to check for a successful task creation message or any other activity on it. Make sure to enable the “Activities” with the toggle switch.

Steps to send an existing report to GitHub

1

Login

Log in to your BetterBugs account.

2

Select project and open report

Select the project (within BetterBugs) that’s integrated with GitHub. Open the report you want to share.

3

Enter details for the GitHub issue

Click "Send to your tools" from the top menu and select "GitHub issue" from the "Select" dropdown.

This fetches the available GitHub repository names for "Your GitHub issue info". Select the GitHub repository and add details, such as Assignees, Labels, and Due date.

NOTE: You can also update any details already available in the bug report.

4

Send to GitHub

Hit the "Create Task" button.

You're good to go.

A new tab with the created GitHub Task opens up posting the Issue to the selected GitHub repository containing all the details and a link to the complete bug report with developer tools info.