Docs/Guides/GitHub Integration

GitHub Integration

How MergeFund works with GitHub to track issues, PRs, and payouts.

How It Works

MergeFund integrates with GitHub through the GitHub App and webhooks to provide seamless bounty management.

GitHub App

When you connect a repository, you install the MergeFund GitHub App. This gives us read access to issues and pull requests.

Webhooks

GitHub sends webhooks to MergeFund when PRs are opened, updated, or merged. This allows us to track work in real-time.

Issue Linking

We detect PRs that reference bounty issues using GitHub's linking keywords (Fixes, Resolves, Closes).

Permissions

The MergeFund GitHub App requests the following permissions:

  • Issues: Read access to view issue details
  • Pull Requests: Read access to track PRs and their status
  • Webhooks: Receive events when PRs are opened or merged

We never request write access to your code or commit history.

Connecting a Repository

  1. 1Go to your MergeFund dashboard
  2. 2Click "Connect Repository"
  3. 3Select the repositories you want to connect
  4. 4Authorize the MergeFund GitHub App