Skill

TestFlight Beta Release

Builds and uploads iOS app archives to TestFlight for beta testing using Fastlane lanes. Handles cert sync with Match, build increments with gym, and pilot uploads for internal/external testers.

iOS

Bash

Homebrew

mobile

deployment

npx claudepluginhub greenstevester/fastlane-skill --plugin match

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Build and upload the iOS app to TestFlight for beta testing.

SKILL.md

Similar Skills

App Store Production Release

Submits iOS app builds to App Store Connect for review using Fastlane. Supports existing TestFlight builds or full pipeline with cert sync, version bumps, archiving, upload, and auto-release.

fastlane-skill

touch-release

Sets up Fastlane release pipelines for iOS/Android mobile apps: code signing with Match/keystores, beta distribution to TestFlight/Firebase, App Store/Google Play submission, CI integration, versioning.

11 tools

tonone

build-distribution

App build, code signing, TestFlight, and App Store distribution for all Apple platforms. Use when preparing releases, configuring signing, uploading to TestFlight, or submitting to App Store.

5 files

fuse-swift-apple-expert

Stats

Stars18

Forks3

Last CommitMay 10, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

TestFlight Beta Release

Build and upload the iOS app to TestFlight for beta testing.

Pre-flight Checks

Fastlane installed: !fastlane --version 2>/dev/null | grep "fastlane " | head -1 || echo "✗ Not installed - run: brew install fastlane"
Fastfile exists: !ls fastlane/Fastfile 2>/dev/null && echo "✓ Found" || echo "✗ Not found - run /setup-fastlane first"
App-specific password: ![ -n "$FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD" ] && echo "✓ Set" || echo "⚠️ Not set - export FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD='xxxx-xxxx-xxxx-xxxx'"

Arguments: ${ARGUMENTS:-none}

What This Does

Syncs certificates via Match (appstore type)
Increments build number (unless --skip-build-increment)
Builds release archive with gym
Uploads to TestFlight via pilot
Optionally distributes to external testers (if --external)

Commands

Standard Beta (Internal Testers)

Run from your project directory (where fastlane/ lives):

fastlane beta

Skip Build Number Increment

fastlane beta skip_build_increment:true

External Testers (with changelog)

fastlane beta_external changelog:"Bug fixes and performance improvements"

Troubleshooting

"No value found for 'username'"

Set your Apple ID in fastlane/Appfile:

apple_id("your@email.com")

"Please sign in with an app-specific password"

Go to https://account.apple.com → Sign-In & Security → App-Specific Passwords
Generate a password named "Fastlane"
Export it:

export FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD='xxxx-xxxx-xxxx-xxxx'

rsync error during export

If you see --extended-attributes: unknown option, Homebrew rsync conflicts with Xcode:

brew uninstall rsync  # Use system rsync

After Upload

Build will appear in TestFlight within 1-5 minutes
Internal testers are notified automatically
External testers require beta_external lane or manual distribution in App Store Connect