How to Connect Git Apps and Manage Repositories in Pronnel

Introduction:

Pronnel offers seamless integration with popular Git platforms like GitHub, GitLab, and Bitbucket. This integration allows teams to link repositories, track pull requests, and manage branches directly from within the Pronnel interface. In this tutorial, we’ll walk you through the process of setting up a Git app instance in Pronnel, authorizing it, and using powerful Git features right from your item view.

Setting Up a Git App Instance

Steps to Follow:

  1. Open the App Settings in Pronnel.

    Add Git App instance in Pronnel App Settings
  2. Click on the Add button to start adding a new app.

    Add Git App instance in Pronnel App Settings
  3. Choose your Git app — GitHub, GitLab, or Bitbucket.

    Add Git App instance in Pronnel App Settings
  4. Click on Create Instance.There are two types of instances private and public.Private is noly visible to you while public is for board menbers

    Authorize Git app with OAuth login
  5. Log in to your Git account and authorize the app when prompted.

Connecting a Repository

Once authorization is successful, Pronnel will prompt you to connect a repository. Select the repo you want to link with Pronnel. This will allow you to monitor and manage repository activities directly from your item view.

Select repository to connect in Pronnel

Configure your app

Choose your board(general type) from the dropdown and then complete configuration

Select repository to connect in Pronnel
Select repository to connect in Pronnel

Using Git Features Inside Item View

Open any item in Pronnel and switch to the Full Pop View. On the right side panel, you'll see a section to select your connected Git app. Choose your app, and the repository details will start appearing below.

Git panel on right side of item view
Git panel on right side of item view

You can rename or configure the repository settings and use the following features:

  • Create Branch – Quickly start a new branch from the item context.
  • Link Branch – Connect an existing branch to this item for visibility.
  • Create Pull Request – Initiate a pull request directly from Pronnel.
  • Link Pull Request – Link an existing pull request to the item.
Creating a pull request from Pronnel item
Options to create or link branches

Use Case: Auto-Create a Pull Request on Bucket Change

Pronnel allows you to automate developer workflows using Git integrations. A powerful example is when you want to automatically create a pull request when an item is moved to a specific bucket—like REVIEW. Let’s see how you can set this up using Automations:

Step-by-Step Setup:

  1. Navigate to Automation from the App Settings or the Automation tab of your board.

  2. Click + Add Automation. Set the Trigger as Bucket Updated.

    Choose bucket updated trigger
  3. In the Condition step, add a filter: If Bucket = REVIEW.

    Set condition for REVIEW bucket
  4. Now for the Action, select External App.

  5. Choose your connected Git app, such as GitHub, and select the Create Pull Request action.

  6. Configure the PR fields—such as source branch, target branch, PR title, and description—based on your item or board data using dynamic fields.

    Choose external app for action
  7. Save the automation. Now whenever an item moves to the REVIEW bucket, Pronnel will automatically create a pull request in the linked Git repository.

This workflow ensures that developers and reviewers are always aligned. By automating the transition from “In Progress” to “Review,” Pronnel removes manual overhead and accelerates your team’s CI/CD process.

Monitoring Pull Request Status

Pronnel keeps you updated with the status of your linked pull requests. You can see whether a pull request is open, closed, or merged right from within the item’s side panel.

Status of pull requests inside Pronnel

Conclusion:

Integrating Git platforms with Pronnel enhances your team's productivity by centralizing version control and project management. With features like branch creation, pull request management, and real-time status updates, developers and project managers can stay aligned without switching tools constantly. Set up your Git apps today and streamline your development workflow directly within Pronnel!

FAQs

Which Git platforms does Pronnel support?

Pronnel supports GitHub, GitLab, and Bitbucket for integration.

How do I authorize my Git account?

Go to App Settings, create a Git app instance, and follow the authorization steps by logging into your Git platform.

Can I connect multiple repositories?

Yes, you can connect multiple repositories across different Git apps by creating separate instances in App Settings.

What actions can I perform from the item view?

You can create/link branches and create/link pull requests directly from the right panel in the item view.

Can I rename a Git app instance?

Yes, once the app is connected, you can rename or reconfigure it as needed.

Will I be notified of pull request changes?

You can see real-time updates on pull request statuses (open, closed, merged) within the item view.

Can I disconnect a repository?

Yes, you can manage or remove the linked repository from the app configuration settings.

Is it possible to link existing branches or pull requests?

Absolutely. Use the "Link Branch" or "Link Pull Request" options in the side panel.

Is the Git integration available on all item types?

Git integration is available in any item view that supports the right-side panel and full pop-up mode.

Do I need admin rights to set up a Git app?

Yes, typically you need admin or configuration permissions in both Pronnel and the Git platform to authorize and link repositories.