Setting up the GitHub App Tile

Matthew Rawls

August 13, 2025 14:40

As part of Simpplr's app tiles feature, we offer several out-of-the-box app tiles your org can set up on home and site dashboards. The article linked below gives an overview of how app tiles work, permissions around setting them up, and various requirements.

Setting Up Out-of-the-Box App Tiles on Dashboards

This article explains the GitHub tile.

GitHub tile

Note:

The GitHub integration is built on the Bring Your Own Integration (BYOI) framework, offering the following key benefits to customers:

Extensibility beyond pre-built use cases – In addition to the existing pre-built app tiles, customers can extend these integrations by building custom API actions and custom app tiles tailored to their specific needs.

Bring-Your-Own-App support – For OAuth-based apps, scopes and permissions can be controlled at the connector level. However, for user-level connections, data access remains restricted to the permissions individual users hold within the external apps, ensuring flexibility and security.

View pull requests from GitHub pending review

Allows users to see pull requests assigned to them for review.

Displays:

PR title
Repository name
Review status
PR URL

Required inputs:

GitHub repository name
User authentication

Prerequisites & setup:

Users must authenticate using their GitHub account.
OAuth Configuration – An OAuth app must be set up within GitHub.
Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the GitHub app.
Once added, configure the OAuth details, including:
- Client ID
- Secret Key
- Auth URL
- Token URL
- Base URL
After completing the configuration, enable the app.
Once enabled, the app will be available under the Add Tile option on the home or site dashboard.

View open pull requests raised by user

Allows users to track the pull requests they have created.

Displays:

PR title
Repository name
PR status
PR URL
(Placeholder for Screenshot)

Required Inputs:

GitHub repository name
User authentication

Prerequisites & Setup:

Users must authenticate using their GitHub account.
OAuth Configuration – An OAuth app must be set up within GitHub.
Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the GitHub app.
Once added, configure the OAuth details as mentioned above.
Enable the app and access it under Add Tile on the home or site dashboard.