tuist share

Generate a link to share your app

Overview

The tuist share command generates a shareable preview link for your iOS, macOS, tvOS, visionOS, or watchOS app. This allows you to distribute app builds to testers, clients, or team members without going through TestFlight or the App Store.

Usage

tuist share [options] [apps...]

Options

--path · string · default: "."

The path to the directory that contains a Tuist or Xcode project with a buildable scheme that can output runnable artifacts.

-p · string

Short form of --path.

--configuration · string

The configuration of the app to share (e.g., Debug, Release). Ignored when app paths are passed directly.

-C · string

Short form of --configuration.

--platforms · string[]

The platforms to share the app for: iOS, tvOS, visionOS, watchOS, or macOS. Ignored when app paths are passed directly.

--derived-data-path · string

The derived data path to find the apps in. When absent, uses the system-configured derived data path.

--json · boolean · default: "false"

Output in JSON format.

--track · string

The track of the preview (e.g., ‘beta’, ‘nightly’). Useful for organizing different distribution channels.

Arguments

apps · string[]

The app name to be looked up in the built products directory, or the paths to the app bundles (.app), an .ipa archive, or an .apk file.

Examples

Share by app name

tuist share MyApp

Looks for MyApp in the build products directory and generates a shareable link.

Share specific app bundle

tuist share ~/DerivedData/MyApp.app

Shares the app bundle at the specified path.

Share IPA file

tuist share ./build/MyApp.ipa

Shares an IPA archive directly.

Share with configuration

tuist share --configuration Release MyApp

Shares the Release build of MyApp.

Share for specific platforms

tuist share --platforms iOS tvOS MyApp

Shares MyApp for iOS and tvOS platforms.

Share with track

tuist share --track beta MyApp

Shares MyApp on the ‘beta’ track.

Share with JSON output

tuist share --json MyApp

Outputs the share information in JSON format for scripting.

Share multiple apps

tuist share App1 App2 App3

Generates shareable links for multiple apps at once.

How it works

1. Tuist locates the app bundle(s) in your build products or at the specified paths
2. Uploads the app to Tuist’s preview service
3. Generates a unique, shareable URL
4. Returns the URL for distribution

Preview links

Preview links:

• Are unique and time-limited
• Can be shared with anyone via email, Slack, etc.
• Allow recipients to install and test the app
• Support iOS, tvOS, visionOS, watchOS, and macOS apps
• Don’t require TestFlight or App Store enrollment

Tracks

Tracks help organize different distribution channels:

tuist share --track nightly MyApp  # Nightly builds
tuist share --track beta MyApp     # Beta releases
tuist share --track stable MyApp   # Stable releases

Recipients can subscribe to specific tracks to always get the latest build for that channel.

Android support

You can also share Android APK files:

tuist share ./app-release.apk

Requirements

• A Tuist account and authenticated session (tuist auth)
• Built app artifacts (.app, .ipa, or .apk)
• Network connection to upload to Tuist’s servers

Related

• Run command
• Build command