What this article covers:
- How to sync GitHub with Trello using Unito
- Managing your issues directly from Trello
- Recommended Unito settings
It's hard to find a tech team not using GitHub nowadays, but despite its great success, it still lacks important project management features.
Why not try to integrate it with the best Kanban app on the market, Trello?
Before we begin:
- Make sure you have an account in these tools
- Make sure you have the right permissions to access these projects
- For certain tools (such as Jira) you need to configure them to accept Unito.
How to sync GitHub with Trello using Unito
If you haven't already, sign up to Unito with Trello and GitHub. You'll be brought to the sync creation steps directly.
If you're already in the Unito App, click on "Add Sync".
The first step is to select what you want to sync. Here choose GitHub and the repository you want to bring into Trello (you can only sync an existing repository due to GitHub API limitations).
Then you choose where to sync this project, in our case it is Trello.
You can either choose to sync with a new Trello board or with an existing Trello board. This is interesting if you have other tasks in Trello that are also part of the project, this way all your local tasks (Trello) and imported issues (GitHub) will coexist.
Finally, you review your sync to make sure everything is good to go. Once you're done that, go ahead and customize the sync before enabling it!
Managing your issues directly in Trello
You're all set, your GitHub issues should start populating your Trello board.
GitHub doesn't offer much flexibility when syncing with your board's lists. Open issues will sync with the first list of your Trello board and closed issues will sync with the last list of your Trello board.
Feel free to have other lists between the two (e.g. "Doing", "Under Review") and sync them with the Open or Closed state in GitHub (go to your sync settings under the "Map Fields" tab, and navigate down to the 'State <-> List' mapping).
Watch your project progress right before your eyes
No need to go through long list of issues in GitHub anymore to see what's being processed and who's working on what. Trello brings the visual interface developers were waiting for.
You can add issues directly from Trello, assign them to GitHub collaborators, comment on them and much more, everything will be synced both ways between the two tools every 5 minutes.
Recommended Unito settings
- Don't want to sync all cards or issues from one tool to the other? Add filters to your sync, you can choose to sync only certain types of tasks or exclude others.
- Make sure the assignees are well-mapped between your tools so you can see who's working on what and assign tasks or comments to people.
- Make sure the imported project workflow is in line with your board lists to have a better view of the team's progress.