Guided setup

Set up your first iOS preview.

Connect GitHub to choose a repository. We’ll guide you through the rest.

Sign in with GitHub Step 1 of 5 · No repository access yet
  1. Sign in with GitHubSo SimPreview knows which pull requests you may open.
    You are here
  2. Pick the repositoryInstall the SimPreview GitHub App on the iOS repo you want previews for.
  3. Add the workflow file and open a pull requestOne small file in the repo. The first pull request build completes this step.
  4. Install the Mac appDownload it once and sign in with the same GitHub account.
  5. Open a build in SimulatorClick Run on the pull request. The app appears in Simulator.
Step 1 of 5

Sign in to GitHub

Use the account you use for iOS development.

Your first preview

Open a pull request.
Then click Run.

SimPreview adds the link when the iOS build is ready.

Read the setup guide