GitHub

Sync and track pull requests and issues

The integration with GitHub lets you sync and track pull requests and issues between projects in GitHub and Forecast. This integration allows you to switch between apps seamlessly.

You simply select which repository you wish to connect the project to, connect the cards, and you'll instantly begin to see links, and status of issues and commits directly in Forecast. A checkmark symbolizes a built issue, while a red x symbolizes that the work is not done yet.

Setup

Step 1: Go to your Admin settings and click App Catalog

github app catalog

Next select the GitHub integration, click here.

image

Step 2: Click Link your GitHub account to activate it

Gitlab screenshot

Step 3: Sign in, accept and authorize the connection

You should automatically return to Forecast.

Once the integration is enabled, in your project settings, select the repositories you would like to have linked to each project. This allows you to select issues or pull requests for that project. Note: You will have to do this for each of your projects.

Step 4: Go to a project you wish to connect

Step 5: Go to Project Settings

Step 6: Scroll down, find the GitHub integration section

forecast_projectsettings-github

Step 7: Find the matching repository in the dropdown menu

Now the repository from GitHub is linked to your project in Forecast.

From thereafter, you're able to attach pull requests and issues to cards.

forecast_card-github

The attachment will work as a link visible on the card in Forecast together with the repository, the creator, and the status of the item. Likewise, a link from the GitHub issue or pull request to the Forecast card will also be present in GitHub.

forecast_card-github-attachedissue