---
title: Build automation
description: How Marteso automatically generates screenshots and IPA binaries from your GitHub repository on every push.
---

# Build automation

Marteso connects to your GitHub repository and automatically builds your app binary (IPA) and generates App Store screenshots on every push. This removes the manual screenshot capture step from your release workflow — screenshots are always in sync with your latest code.

## How it works

1. You link a GitHub repository to your app in **App Settings → GitHub Repository**
2. On every push to your connected repository, Marteso triggers a build job
3. The build produces a signed IPA and generates App Store screenshots
4. The generated screenshots are attached to the current version in **Versions**
5. You can review, approve, and push metadata + screenshots to App Store Connect from **Versions**

## Step 1 — Link your GitHub repository

1. Open **App Settings** for your app
2. Under **GitHub Repository**, click to connect and select your repository
3. Provide **iOS Code Signing** credentials (Team ID and signing certificate) so Marteso can sign the build

Once linked, Marteso will show the connected repository name and a confirmation.

![App Settings showing GitHub repository linked and iOS code signing configured](/img/screenshot-management-overview.png)

## Step 2 — Push to trigger a build

Push any commit to your repository. Marteso automatically:

- Checks out your latest code
- Builds and signs the IPA
- Runs your UI tests to generate screenshots at all required device sizes
- Attaches the output to the active version in **Versions**

## Step 3 — Review builds in Logs

Open **Logs** to see all build jobs triggered by GitHub pushes.

Each job shows:
- Commit hash and branch
- Status: **COMPLETED** (IPA ready) or **FAILED**
- Timestamp

You can also click **Run Now** to trigger a build manually without pushing a new commit.

## Step 4 — Review and push metadata + screenshots

Once a build completes, open **Versions** to review:

- The generated screenshots attached to the current version per locale
- The app metadata (name, subtitle, keywords, description) per locale
- Use **Push Metadata** to push approved metadata to App Store Connect
- Use **Sync from ASC** to pull the latest metadata from App Store Connect into Marteso

## UI test requirements

Marteso runs your app's UI tests to capture screenshots. Your repository must include UI tests that use `XCTest` screenshot attachments. If your test suite doesn't generate screenshots, the build will succeed but no screenshots will be attached.

Refer to Apple's [Writing UI Tests](https://developer.apple.com/documentation/xctest/writing_tests_and_setting_test_conditions) documentation for how to add screenshot capture to your UI test targets.