Marteso Docs

GitHub integration

Connect Marteso to your GitHub repositories to automate screenshot generation and binary signing.

Two pipelines

Marteso uses GitHub for two workflows that run from push, pull request, or tag events and report status back as GitHub commit statuses.

PipelineWhat it does
Screenshot pipelineRuns XCUITest, frames screenshots, and generates localized captions.
Binary pipelineSigns your app with your provisioning profile and distribution certificate.

Connect GitHub

Go to Settings -> Integrations -> GitHub and authorize Marteso to access your account. You only need to do this once.

Marteso app settings screen for connecting an app to GitHub.
Connect the repository that contains your iOS app source and UI tests.

Screenshot pipeline

  1. Connect GitHub in Settings -> Integrations.
  2. Select the repo containing your UI tests under your app -> Screenshots -> Pipeline.
  3. Marteso installs a webhook automatically.
  4. Push a commit or trigger manually. Marteso runs the test and delivers finished screenshots.

See Screenshot automation for the full guide.

Binary pipeline

  1. Connect the repo containing your app source.
  2. Add your mobile provisioning profile and distribution certificate in Marteso settings.
  3. Marteso signs the binary automatically when the pipeline runs.
  4. The signed binary appears in Version Management, ready to submit to App Store Connect.
Marteso Version Management area where signed binaries and versions are reviewed.
Signed binaries appear in Version Management after a successful binary pipeline run.

Commit status reporting

After every pipeline run, Marteso posts a commit status to GitHub: pending while the pipeline runs, success when screenshots or binaries are ready, and failure when tests or signing fail.

Marteso logs area showing where pipeline status and failures are reviewed.
Pipeline status and logs make failed tests or signing errors visible during review.

Notes

Only native Swift apps are supported for the screenshot pipeline because it requires XCUITest. The pipeline runs on Marteso's build server, so no local Mac is required.