> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Integration

> Connect Spur with GitHub for automated testing on pull requests.

## Overview

The GitHub integration lets you run Spur tests automatically on every pull request. Test results appear as status checks directly on the PR, and you can use branch protection rules to block merges when tests fail.

<Columns cols={2}>
  <Card icon="play" title="Automated Test Execution">
    Test plans run automatically on every pull request without manual intervention.
  </Card>

  <Card icon="circle-check" title="PR Status Checks">
    Pass/fail results appear directly on the pull request in GitHub.
  </Card>
</Columns>

For a full setup walkthrough including YAML workflow files and branch protection, see the [GitHub CI/CD guide](/running-tests/cicd/github).

## Quick reference

Spur automatically generates the workflow YAML files for your repository. You can download them from the GitHub Integration Settings page in Spur and add them to your repository under `.github/workflows/`.

<Note>
  The full CI/CD setup guide covers everything you need, including configuring test plans, downloading YAML files, and enabling branch protection. See the [GitHub CI/CD page](/running-tests/cicd/github) for step-by-step instructions.
</Note>