Skip to main content

​
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:
  • 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