GitHub for Miro

GitHub for Miro will enable you to integrate both platforms and streamline your workflows. By leveraging the strengths of these apps in a cohesive working space, you’ll be able to improve efficiency and collaboration.

Key features

GitHub for Miro allows you to:

Convert Miro sticky notes into GitHub issues using app cards.
Import issues from GitHub and place them in Miro as app cards.

Guide

The following sections will guide you on:

How to install GitHub for Miro

Any user can install GitHub for Miro to a Miro team. However, admins can restrict non-admins from adding apps if they're on Miro's Business or Enterprise Plan. To learn more, read our FAQ, Can non-administrators install apps?

Go to Miro Apps Marketplace and search for “GitHub for Miro”. On the landing page, click Connect.
Next, select a team from the dropdown menu and click the Add button.

Authorizing GitHub for Miro

Open a board in your team space and go to the toolbar menu. Click on the GitHub app icon > Login with Miro.
Click on the Authorize GitHub for Miro button.
You should see a success page saying that GitHub has now been authorized. Click Install GitHub application.
You will be redirected to GitHub to install the app. Click Configure.
Select the account or organization you’d like to install the app to.
If you’re not an admin for that organization, the Configure option will not be available to you.
If you’re successful, you will be directed to a page that lists all the requirements for the app to run.
Select All repositories and click Save.
You can select specific repositories if you want to. However, when converting Miro sticky notes into app cards, you can only select the repository that you have given the app access to.
Next, you will need to configure the settings of the Miro board by selecting a default GitHub organization.
Open a Miro board in your organization and click on the GitHub menu from the toolbar menu.
Click on the dropdown list under Connected GitHub Organization and select the GitHub organization you want the app to read from. Click Save changes.
This setting allows users to limit what repositories are displayed by default when converting sticky notes into GitHub issues.
That’s it! the GitHub connection is now authorized.

Creating GitHub issues from Miro sticky notes

Create a sticky note on your Miro board and select it.
Select the GitHub icon from the toolbar menu.
Fill out the form with relevant information:
1. Repository: The repository you want to push this Miro card to.
  The repositories listed in the dropdown menu will be associated with the default GitHub organization you’ve chosen when configuring the app.
2. Issue summary: The text from the Miro app card will be automatically included here.
3. Assignees: The users you want to assign the issue to.
4. Labels: The issue’s associated labels.
5. Milestone: The issue’s current milestone.
6. Description: What the issue is about.
Click Convert issue to GitHub after filling out the form.
The sticky note will be converted into an app card and a GitHub issue will be created in GitHub.
You can visit the related GitHub issue by clicking on the link in the detailed view of the app card. To see more detailed information on the Miro app card, click the expand icon on the top right of the card.

Creating multiple GitHub issues with Miro sticky notes

Create multiple sticky notes and then select them.
Click the GitHub icon on the toolbar menu.
Fill out the form with relevant information and choose your repository. Then, click Convert issue to GitHub.
The sticky notes will be converted into app cards and corresponding issues will be created in GitHub.

The app cards and GitHub issues will share the same information that you’ve filled out in the form in Step 3.

FAQ

Who can install GitHub for Miro?

Any Miro user, regardless of the plan they are on, can install GitHub for Miro for their team.

Can I restrict non-administrators from installing GitHub for Miro

Administrators who are on Miro’s Business or Enterprise plans can restrict non-admins from installing apps. For more information, read Miro’s documentation on app management.

Security statement

ServiceRocket is committed to the protection and security of our customers' information. Learn more about GitHub for Miro’s security practices in our security statement.