How to Connect Git Repository to Your BuddyBoss App

Introduction

Streamline your development workflow by linking a Git repository which hosted on GitHub or GitLab directly to your BuddyBoss App. Once connected, any branch you choose can be automatically merged into your Test App and Release App builds, eliminating manual code shipping. This guide shows you how connect Git Repository to Your BuddyBoss App, generate and paste access tokens, and select branches in WordPress so you can deploy custom code without leaving the admin.

Prerequisite

You must be on a plan that includes Developer Access and have your app already connected under BuddyBoss App > Configure > Connect.

Also, make sure to check out our App Development tutorials to learn how to write custom code for your app, including how to set up your Git repo, and how to deploy custom code to your Test App.

Tutorial Video

Configuring Your Repository on BuddyBoss.com

1. Log in at buddyboss.com and go to Apps > Manage for your target app.
   
2. Scroll to the Developer Access section.
   
3. Under Git Provider, choose GitHub or GitLab.
   
4. Paste your Repository URL (SSH format).
   
5. Enter your Access Token (see provider steps below).
   
6. Click Save.
   

GitHub Configuration

1. In BuddyBoss.com, set Provider to GitHub.
   
2. Enter the SSH URL, e.g. [email protected]:username/repo-path.git.
   
3. Create a GitHub Personal Access Token:
   
   • Go to Settings > Developer settings > Personal access tokens.
     
   • Click Generate new token and select the repo scope.
     
   • Click Generate token, then copy the token.
     
4. Paste the token into BuddyBoss.com and click Save.
   

GitLab Configuration

1. In BuddyBoss.com, set Provider to GitLab.
   
2. Enter the SSH URL, e.g. [email protected]:username/repo-path.git.
   
3. Create a GitLab Personal Access Token:
   
   • Go to User Settings > Preferences > Access Tokens.
     
   • Name it, check read_api and read_repository, then Create token.
     
   • Copy the generated token.
     
4. Paste the token into BuddyBoss.com and click Save.
   

Selecting Branches in WordPress Admin

1. Go to BuddyBoss App > Configure > General.
   
2. Scroll to the Development section.
   
3. Under Release App, select the branch to merge into your Release builds.
   
4. Under Test App, select the branch to merge into your Test builds.
   
5. Click Save Changes.
   
6. Request a new build to apply your custom code changes.
   

Troubleshooting & FAQs

Q: Invalid repository URL?
A: Make sure you’re using the SSH format (git@…) not HTTPS.

Q: Access token isn’t accepted.
A: Regenerate with correct scopes. Repo for GitHub; read_api & read_repository for GitLab, and update in BuddyBoss.com.

Q: My branches don’t appear in the dropdown.
A: Click Refresh Data in the Development settings, or verify the branch exists and is pushed to your remote repo.

Q: Custom code isn’t in my build.
A: Confirm you selected the branch before requesting the build and that the build completed successfully.

Q: I don’t see the Development section.
A: Verify you’re on a Developer Access plan and that your app is connected under Configure > Connect.