Skip to main content
Yboard integrates with GitHub through a GitHub App, letting you link repositories to your apps for source control and deployment workflows.

​
Installing the GitHub App

  1. Open the Yboard dashboard and navigate to your app’s Settings.
  2. Click Install GitHub App.
  3. You’ll be redirected to GitHub to authorize the Yboard GitHub App.
  4. Select which repositories (or all repositories) the app can access.
  5. After authorization, GitHub redirects back to Yboard and the installation is stored for your organization.
Once installed, the GitHub integration is available for all apps within that organization.

​
Linking a repository to an app

After the GitHub App is installed:
  1. Go to your app’s Settings > GitHub section.
  2. Browse the list of accessible repositories (paginated, 30 per page).
  3. Select a repository to link it to your app.
  4. Optionally browse and select a specific branch.
Each app can be linked to one repository at a time. Changing the linked repository updates the association immediately.

​
Browsing repositories and branches

From the dashboard you can:
  • List repositories — View all repositories the GitHub App has access to, with pagination.
  • List branches — Browse branches for any accessible repository, including protected branch indicators.
  • View selected repository — See which repository and branch are currently linked to an app.

​
Repository access tokens

When your app needs to perform Git operations (clone, pull, push), Yboard generates a temporary access token scoped to the linked repository. These tokens are short-lived and automatically provisioned — you don’t need to manage them manually.

​
Uninstalling

To remove the GitHub integration:
  1. Go to your organization’s Settings.
  2. Click Uninstall GitHub App.
This revokes the installation and clears all repository links for the organization. You can reinstall at any time.

​
API reference

If you’re building on the Yboard platform, the following actions are available: