Skip to content

Run previews with the macOS app

For Apple previews, the Tuist macOS menu bar app is an alternative to the CLI, whether the build came from Xcode, Bazel, or Once. The publication workflow's signing and eligibility requirements still apply.

Install#

Download the app or install it with brew install --cask tuist/tuist/tuist.

Run a build#

Select a compatible device or simulator in the menu bar app, then click Run on a preview page.

The macOS app first requests the latest compatible preview per app. On older servers that select distinct apps before applying platform filters, it falls back to paginated history without imposing a cutoff that could hide an available build.

For access and organization, see visibility and tracks.