---

name: ios-deployment description: Automate provisioning, signing, and deployment with Fastlane. Use when provisioning iOS apps, managing code signing, or automating deployments with Fastlane. metadata: triggers: keywords: - Fastfile - Appfile - Matchfile - ios_bundle_id - provisioning_profile - testflight

iOS Deployment

Priority: P1 (HIGH)

Implementation Workflow

1. Set up Match — Use fastlane match for centralized certificate and profile management. Avoid manual signing.
2. Configure build settings — Set PROVISIONING_PROFILE_SPECIFIER explicitly if using manual/CI signing.
3. Script Fastlane lanes — Create beta (TestFlight) and release (App Store) lanes in your Fastfile.
4. Automate versioning — Use increment_build_number to auto-bump build numbers.
5. Automate TestFlight uploads — Trigger on every successful merge to staging.
6. Set export compliance — Automate in the iOS Info configuration or Fastlane to avoid metadata pauses.

See Fastlane and Match setup examples

Anti-Patterns

• No Manual CI Signing: Use Match for automated certificate management
• No Certificates in Repo: Use private git repo for Match certificates
• No Manual Versioning: Use Fastlane increment_build_number for build numbers

References

• Fastlane & Signing Setup

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

• iOS app configuration

Remediation anchors

• Remediation anchors: PROVISIONING_PROFILE_SPECIFIER, Fastfile, fastlane match