Skip to main content
Installing and testing on a real iPhone Level: Beginner 11 min read

Sharing Your Pre-Release App with Friends: TestFlight External Testing Setup

Learn how to share your pre-release iOS app with friends, colleagues, and external testers using TestFlight public links and email invitations via FlightDeck.

Published: 2026-10-31 • Last Updated: 2026-11-01 • Author: Kip Lawrence
Key MCP Tools: beta_groups_listbeta_group_createbuild_add_to_beta_groupbuild_beta_details_get

Direct Answer: Sharing Pre-Release Builds with Friends

On iOS, you cannot simply email an .ipa file or send an installation link to friends. Apple's operating system strictly prevents installing apps without cryptographic signature validation and provisioning authorization.

Apple's official platform for sharing pre-release software is TestFlight External Testing.

Through TestFlight, you can generate a Public Join Link (https://testflight.apple.com/join/...) and share it in group chats, Discord servers, or messaging apps. Anyone with an iPhone can tap the link, install the free Apple TestFlight app, and install your approved build—without needing access to your developer account or registering device UDIDs.

Using FlightDeck, you can ask your AI coding assistant to create an external beta group with a public link, attach your latest processed build, and verify distribution status. Because sharing builds alters your App Store Connect account, FlightDeck stages the change for your authorization in the native FlightDeck Desktop Approval Center. Once Apple's lightweight Beta App Review approves the build, your public link becomes active worldwide.


What You Need

Before creating a public testing link, ensure you have:

  1. Paid Apple Developer Program Membership: Required to distribute builds through TestFlight ($99/year).
  2. Uploaded & Processed Build: An .ipa binary uploaded to App Store Connect that has finished processing (see Testing Wire-Free on Physical Hardware).
  3. FlightDeck for Mac: Running and connected to your AI assistant (see our Cursor Setup Guide or Claude Code Guide).

Internal vs. External Testing: Why Friends Need External Groups

App Store Connect provides two distinct testing tiers. Choosing the wrong tier is the single most common reason developers get stuck when trying to share an app:

Attribute Internal Testing (Core Team Only) External Testing (Friends & Public Beta)
Max Capacity Up to 100 testers Up to 10,000 testers across multiple groups
Tester Requirement Must have an Apple ID invited as a team member in your Apple Developer account Anyone with an iPhone. Zero developer account access needed
Apple Review Required? NO. Available once backend processing and export compliance clear YES. First build of each version requires Apple Beta App Review
Distribution Methods Direct Apple ID assignment Public Shareable Link or individual email invites
Best Used For You and co-founders Friends, family, beta testers, and public communities

Warning

Never add casual friends or acquaintances as "Internal Testers." Doing so requires granting them administrative or developer user roles in your Apple Developer team. Always use External Testing for friends.


Step-by-Step Solution: Setting Up External Distribution

Instruct your AI assistant to check your existing TestFlight groups and configure a dedicated external testing group:

Copy and paste this prompt into Cursor, Claude Code, Antigravity, or Windsurf:

TEXT
Check my App Store Connect account for [Your App Name]. Create a new external TestFlight beta group named 'Friends & Early Testers' with a public join link enabled and a tester cap of 100. Stage the proposal for my approval in FlightDeck.

What Your Assistant Does:

  1. It queries App Store Connect to verify whether an external group with this name already exists.
  2. If not, it stages a group creation request configuring isInternalGroup: false, publicLinkEnabled: true, and publicLinkLimit: 100.
  3. A confirmation card appears in the FlightDeck Desktop Approval Center on your Mac.
  4. You review the group name and settings, then click Approve.

Step 2: Attach Your Latest Valid Build (Prompt)

Once your external group exists, attach your latest processed build:

TEXT
Find our most recent valid build of [Your App Name] in App Store Connect and attach it to our 'Friends & Early Testers' beta group. Also help me draft concise 'What to Test' notes covering our core features.

What Your Assistant Does:

  1. It locates the latest build where processingState is VALID.
  2. It drafts clear, reviewer-friendly "What to Test" notes (e.g., "Testing account signup, onboarding flow, and core document viewing on iOS 17 and 18").
  3. It stages the build attachment in FlightDeck. You review the build number and click Approve in the Approval Center.
  4. You paste the drafted test notes into the build's TestFlight tab in App Store Connect (or have your assistant dispatch them).

Step 3: Apple Beta App Review (Apple Approval)

Before external testers can download your build or join via public link, Apple conducts a streamlined Beta App Review:

  • Turnaround: Review times vary depending on Apple's review queue volume. (Subsequent minor builds within the same marketing version are often processed more quickly).
  • Review Scope: Reviewers verify that the app launches without crashing on test devices, does not contain offensive content, and provides test credentials if your app requires an account login.
  • Activation: The moment Apple approves the build, your Public Link activates automatically.

Once submitted, ask your AI assistant to check the review status and retrieve the active link:

TEXT
Check our 'Friends & Early Testers' beta group for [Your App Name]. Tell me if Apple has approved the build for beta testing, and retrieve our active TestFlight public join link.

What Your Assistant Returns:

Your assistant checks the remote Apple status. Once approved, it returns your shareable URL:

TEXT
https://testflight.apple.com/join/AbCdEfGh

What Your Friends Experience (Copy-Paste Instructions)

Send this simple message to your friends along with your public link:

TEXT
Hey! I'm testing my new iOS app on TestFlight before releasing it to the App Store. 
Here is how you can try it:

1. Download the free "TestFlight" app from the App Store on your iPhone.
2. Tap our invite link: https://testflight.apple.com/join/[YourCode]
3. Tap "Accept", then tap "Install".

The app will install directly on your home screen. You can send feedback or report bugs anytime by taking a screenshot inside the app and tapping "Share Beta Feedback". Thanks for testing!

Troubleshooting Common External Testing Issues

  • Cause 1 (Review Pending): The build has been attached to the group, but Apple Beta App Review has not finished evaluating it.
  • Cause 2 (Tester Limit Reached): The number of testers who joined has reached the limit you configured (e.g., 100 testers).
  • Resolution: Ask your assistant: > "Check the Beta App Review status and current tester count for our 'Friends & Early Testers' group on [Your App Name]." If the cap was reached, you can raise the limit in App Store Connect under the group settings.

2. Build Blocked by "Missing Export Compliance"

  • Symptom: Build is valid, but Apple prevents submitting for beta review.
  • Resolution: Add <key>ITSAppUsesNonExemptEncryption</key><false/> to your Info.plist (see Fixing Missing Encryption Key) to clear this automatically on all future builds.

3. Reviewer Rejection: "We were unable to test your app"

  • Cause: Your app requires a login, but you did not provide working demo account credentials in your review notes.
  • Resolution: Ask your assistant: > "Draft App Review notes for [Your App Name] providing demo login credentials and instructions for the reviewer."

Connect Your AI Agent to App Store Connect

FlightDeck runs locally on your Mac, keeping private keys secure in your macOS Keychain and executing mutations only after your explicit approval.

Download FlightDeck on Mac App Store