GitHub Integration

GitHub is a version control platform that allows you to track changes to your codebase, flag bugs and issues for follow-up, and manage your product's build process. 

With the monday.com integration with GitHub, you can supercharge GitHub's task-management capabilities and discuss builds with your team before they enter your codebase 👍🏽

Adding the integration to your workflow

Step 1

To add an Integration, go to the board you want to create an Integration for and click on the Integration button, located on the upper right of your screen as below: 
 
Screen_Shot_2019-01-14_at_10.56.46.png

Once you've opened the integrations page, you'll see all the wonderful apps we integrate with :) Go ahead and click "GitHub".

Screen_Shot_2019-01-14_at_10.59.46_copy_6.png

Step 2

Connect your GitHub account by clicking "Connect to GitHub" and then logging in with your GitHub credentials. 

Screen_Shot_2019-01-09_at_7.24.05_PM.png

Step 3

Select the integration you want to add to your board. The GitHub actions supported by monday.com are:

  • When tagging a commit in this repository, create a pulse in this group with this prefix.
  • When a new pull request is opened in repository, create a pulse in group.
  • When a pulse ID is mentioned in a commit in this repository, create an update to the relevant pulse. 
  • When push to master branch of repository, create pulse in group.
  • When issue created in this repository, create a pulse in this group
  • When a new pulse is created, create an issue in this repository

 

 Step 4

When setting your integration, you can select which data will be mapped into each column:

   


   

Github Integration column

When selecting which data will be mapped into each column, the integration column will be added automatically with the tip that will explain the column purpose, to maintain the connection between the parameters in both apps:

     

 

Note: Want more ideas for how to automate and integrate monday.com with other platforms? Check out this article: monday.com Automations

 

Simple Use Case: Using monday.com to log Github Issues

With the GitHub integration, you can supercharge your Sprint Planning board by syncing it with your codebase in GitHub! This way, you can communicate about specific issues in monday.com while still having them tracked in GitHub for easy access. 

First, add the "When a new pulse is created, create an issue in this repository" to your board. 

Screen_Shot_2019-01-09_at_7.40.51_PM.png

Then, set up a Sprint Planning board with each pulse as a bug or feature that your team is working on. 

 

Screen_Shot_2019-01-08_at_6.31.11_PM.png

As you add more tasks to your team's sprints, they will also appear in GitHub!

Screen_Shot_2019-01-08_at_6.33.55_PM.png

 

Note: Need a refresher on using monday.com to communicate with your team? Check out this article: Communicating in monday.com

  

More assistance

If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly! 

And if you have any questions about this or anything else in this article, feel free to reach out to us at customer success at support@monday.com