GitHub App

Register and install a GitHub App to enable monolayer to receive repository events and trigger automated deployments.

About the GitHub App

A GitHub App is an integration that lets monolayer receive repository events and act on selected repositories. The control plane uses a manifest-based setup flow to create the app and store the returned credentials.

Prerequisites

Before continuing, make sure you have at least one GitHub organization configured.

If you don't have one yet, create a GitHub organization first, then return to this setup flow.

Setting Up a GitHub App

Follow these steps to register and install a GitHub App for your organization.

Steps

1. Choose Settings in the global sidebar.
2. Choose GitHub Apps.
3. Click Configure and install app.
4. Type your GitHub organization name.
5. Click Create and configure app.
6. Click Continue to GitHub.
7. Select your target organization on GitHub.
8. Click Create and configure GitHub App.
9. Type a name for your GitHub App, and click Create.
10. Select All repositories or Only select repositories on the installation page.
11. Click Install & Authorize.

What happens next

GitHub installs the app and redirects you back to the monolayer control plane with a setup confirmation.

Webhook Deliveries

The Webhook Deliveries panel is a built-in diagnostics and debugging tool located directly within the monolayer control plane under the GitHub App settings (Settings > GitHub App).

It displays a real-time, interactive feed of recent webhook payloads sent by GitHub to your monolayer control plane, along with status codes, payload structures, and response details.

If a deployment doesn't start or something seems stuck, you need to know if your control-plane is actually receiving these notifications. Sometimes GitHub experiences delays, or its webhook delivery system might be down.

Instead of navigating to GitHub, with the Webhook Deliveries panel you can immediately see if GitHub sent the webhook, when it was sent, whether it succeeded, and exactly how monolayer responded—all without leaving your control-plane.

The Webhook Deliveries panel acts as a direct window into your GitHub App's activity with:

• Live Activity Feed: Displays a list of the 30 most recent webhooks sent to your monolayer app, including the event type (e.g., push, pull_request), status code, unique delivery GUID, processing duration, and delivery timestamp.
• Instant Refresh: Click Refresh to instantly check if GitHub successfully sent the webhook and if monolayer received it.
• Detailed Payload Inspection: Click the View Details icon (eye icon) on any delivery to inspect:
  • Request: The exact headers and JSON payload GitHub sent to monolayer.
  • Response: The exact response headers and payload monolayer sent back to GitHub, helping you spot any processing errors or configuration issues instantly.
• Load More: Click Load More at the bottom of the list to paginate backward in time and inspect older deliveries.