You can learn how to enable integrations here.
Step 1 - Connecting your GitHub organization with your Favro organization.
First of all you will need to be a member of both a GitHub organization and a Favro organization. In order to use the integration you will need to connect these organizations. If you did not sign up to Favro using your GitHub credentials don’t worry you can connect your GitHub account afterwards through the in house App Store in Favro (accessible by clicking your avatar in top right corner when logged in to Favro).
Step 2 - Authorize application.
When clicking the Connect with GitHub button in the App Store you will be taken to your GitHub account in the browser (if you’re logged into GitHub). You will be displayed with an authorization page.
Under Organization access you will see the GitHub organizations where you can grant Favro access. Press the Grant access button for your desired organization and enter your GitHub password.
The Grant access button will then be changed to Revoke, as an indicator that you have granted that organization access to Favro.
Then press the Authorize application button and the tab will close and take you back into Favro. In Favro you will see that the integration has been granted access to your GitHub account.
Step 3 - Create a GitHub Issues Board/Backlog.
Next step is to create a board or a backlog and connect it to your GitHub repository. Click the + Icon next to the name of your collection in the top left corner.
Then choose which GitHub repository within your GitHub organization you want to connect to that board.
You can also customize your syncing options, either Favro syncs with your GitHub Issues, your pull requests or with both. You can also choose which columns to map to which GitHub labels, either use the the pre-entered columns or customize after your own liking. When you’re done just press the Create GitHub board button.
Step 4 - Managing your board/backlog.
It is possible to re-map your columns or to create new columns and map them to GitHub labels afterwards. Just press the name of the column and choose Map to GitHub label.
If no label is specified for a column, all open issues in GitHub will be mapped to this column. A tip, create a backlog in Favro connect it to your repository and don’t map it to any specific label, then it can serve as the backlog of all GitHub issues to be worked on.
The following GitHub issue fields are synced to and from Favro:
- Title and Description.
- Labels are mapped to a Favro tag with the same name.
- Comments (if a non-Favro user posts a comment in GitHub, Favro will display the GitHub username and avatar for the user).
Changes in Favro are immediately propagated to GitHub. However, some changes from GitHub will not be updated directly in Favro as they are not exposed by GitHub’s APIs and webhooks. Whenever you open a card in Favro, it will sync any changes from GitHub. It is also possible to refresh all issues from the repositories mapped to a Favro board or backlog by choosing Refresh from GitHub from the hamburger menu of the board or backlog.
We are always looking to expand and improve our integrations, so if you are missing additional functionality don't hesitate to reach out to us and let us know!