# Getting started with Xcode Cloud Use Xcode Cloud to build and test your app in the cloud during development. ## Overview Xcode Cloud is a continuous integration and delivery (CI/CD) system built into Xcode to create apps and frameworks for Apple platforms. Xcode Cloud builds and tests your app in the cloud in parallel across multiple devices and operating system versions as you write code and iterate quickly on new features during development, and later during distribution. Xcode Cloud helps catch regressions, bugs, and performance issues as you commit your changes. To add your project to Xcode Cloud, you: 1. Select your app or framework. 2. Connect your remote repository to Xcode Cloud. 3. Start your first build. 4. View the status in the Report navigator. After adding your project to Xcode Cloud, you can customize your configuration as needed for your specific development and distribution needs. For more information, see [Setting up your project to use Xcode Cloud](/documentation/Xcode/Setting-up-your-project-to-use-Xcode-Cloud) and [Configuring your first Xcode Cloud workflow](/documentation/Xcode/Configuring-Your-First-Xcode-Cloud-Workflow). Later, to start collecting feedback from people on your beta builds, see [Distributing your Xcode Cloud builds through TestFlight](/documentation/Xcode/distributing-your-xcode-cloud-builds-through-testflight). ## Before you begin Before you start using Xcode Cloud, you need to: - Join the Apple Developer Program. - Add your account to Xcode in Apple Accounts settings. - Assign your project to a team to create your provisioning profile. - Have admin access to a remote source code repository. - Push your latest project changes to the remote repository. For information on the Apple Developer Program, see [Become a member](https://developer.apple.com/programs/enroll/). ## Configure Xcode Cloud for your project To use Xcode Cloud with your project: 1. Open your project in Xcode. 2. In the Report navigator, click the Cloud tab. 3. Click the Get Started button that appears below.  > Note: If you don’t have a remote repository, Xcode offers to create one for you. ## Select a product in your project In the Select Product sheet that appears, find your app or framework: 1. Select your app or framework from the list of products that Xcode detects. 2. If necessary, select the team for the app or framework. 3. Click Next.  ## Connect your source code repository In the Connect Source Code Repository sheet, click Connect next to your repository to grant Xcode Cloud access. 1. In the browser window that appears, sign in to your App Store Connect account if necessary. 2. Follow the instructions that appear to authorize Xcode Cloud access to your remote repository. 3. Click Continue in Xcode when you’re done. 4. In Xcode, click Next to add your project’s remote repository to Xcode Cloud. > Note: Xcode Cloud only fetches your code when it starts builds on ephemeral virtual machines. After the builds complete, Xcode Cloud deletes your files and never stores your code. ## Review the workflow and start your first build In the Setup Complete sheet, Xcode shows you a default workflow that: - Starts a build on every change to your `main` branch. - Uses the latest macOS and Xcode versions. - Archives your app or framework.  Use this basic workflow at first and customize it later. To edit the workflow, click Details in the Workflow row under Start First Build and make your changes in the sheet that appears. For more information on choosing start conditions, see [Configuring start conditions](/documentation/Xcode/Configuring-Start-Conditions). To begin using Xcode Cloud, click Start First Build. > Note: Xcode stores metadata about the product in the `xcshareddata/xcodecloud/manifest.json` file in your project bundle. Push changes to this file to your remote repository so your team has access to the product in Xcode. ## View the progress of your build In the Report navigator, you can watch the build run. In the Cloud pane, expand the product and click the workflow. Xcode shows the workflow details on the right.  If you encounter build issues, see [Resolving common configuration and build issues](/documentation/Xcode/Resolving-Common-Configuration-and-Build-Issues). ## Build another target in the same workspace In the Cloud pane of the Report navigator, choose Create Workflow from the More pop-up menu in the lower-left corner of the navigator (Integrate > Create Workflow). In the Select Product sheet, choose the target and click Next. In the Setup Complete sheet, choose the target branch from the Branch pop-up menu and click Start First Build. Xcode adds a workflow to build the target to the Cloud pane. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)