Skip to main content

Adding a Build Profile & Connecting a Repository

New to Appcircle Build module? Follow our quick start guide to build your iOS and Android apps in the cloud.

The Build Module allows you to streamline and automate your mobile app build flows.


The Build Module is the first step to automate your CI/CD processes via Appcircle.

Create a build profile (app)

A build profile is an app that you can build in a target OS and framework.

To create your first build profile, click on the orange "Add New" button on the top left of the screen.

Enter a name for your build profile and select the target operating system (iOS or Android) and target platform.

Connect your repository

You can connect GitHub through a GitHub app or Bitbucket and GitLab repositories to your build profile through OAuth apps. Alternatively, You can connect private repositories through SSH and public repositories directly on GitHub, Bitbucket, GitLab, and other compatible git providers such as Azure DevOps and AWS CodeCommit. (Please refer here for more information on AWS CodeCommit connections.)

You can also connect to your Self Hosted Bitbucket and GitLab account directly within Appcircle.

If you authorize Appcircle to connect to your Github, BitBucket, or GitLab account, you can auto-build your project with hooks, get build statuses and the full list of commits. If you connect to a repository through SSH or through a public URL, you need to set up webhooks manually.

To test drive Appcircle, you can find various sample projects in the Appcircle GitHub page or you can just press on the Quick start using the sample repository button to populate the repository URL field with a compatible project based on the selected framework.

When the "Autofill" toggle is activated on the Select Repository popup, Appcircle will try to create a default configuration using the selected repository and fill in the necessary fields.


When you have exceeded the build limit of your plan, Appcircle will not be able to Autofill your build profile, although you activated the toggle.

Refer to the relative documents under this page about the connections and differences between connection types:

View the newly created build profile

You will see your build profile once it has been created. Click on the build profile to connect a repository and fetch your code to Appcircle.

Appcircle will then pull your branches, commits, and other information from your repository.

Delete a Build Profile

In order to delete a build, simply click on the Three Dot and click delete.

After the prompt, the profile will be deleted.

In order to free up storage in your organization, you should also remove the other references pointing to the artifact. In example, if you have the same artifact on the testing distribution, you should also delete those artifacts as well.

Is your artifact storage full? Learn more about freeing up space here.

Need help?

Get help from Appcircle's support team, or see how others are using Appcircle by joining our Slack Channel.

Preview of Slack