​
Overview

The Github integration allows you to link GitHub repositories to projects in Tunnel. Once linked, Tunnel will display the status of the comments on the corresponding branch. This allows you to see how many comments have been resolved and how many are still open.

​
Configuration

​
Connect Github

Navigate to Settings > Integrations and click the Connect button.

With your Github organization connected, you can link repositories to projects in Tunnel.

1

Create a new project

To create a new project and link a repository to it, navigate to Projects and click the New project button.

2

Select a repository

In the Link a Repository field, select the repository you want to link to the project.

1

Navigate to your project's settings

To link a repository to an existing project, navigate to Projects and select the project you want to link a repository to. Navigate to the Settings tab.

2

Select a repository

Scroll down to the GitHub Repository section and select the repository you want to link to the project.

​
Adding git metadata to comments

​
Development

The Tunnel CLI will automatically detect the repository and branch you are working on and add git metadata to comments.

​
Staging and Production

To add git metadata to comments in your hosted environments, you will need to pass a git branch to the <TunnelToolbar /> component or <script> tag.

<TunnelToolbar projectId="PROJECT_ID" branch="BRANCH_NAME" />

​
Sync Pull Requests

Pull requests receive generated PR messages from the Tunnel bot. The PR message tracks how many comments have been resolved and how many are still open. The PR message is updated every time a comment is resolved or reopened.