README.adoc

Adding a GitHub Repository

If your repository lives in GitHub, you can connect your repository automatically, or connect via SSH if you prefer.

If you prefer SSH, buddybuild will automatically generate a secure SSH key for you to install into your source control system. Buddybuild will use this key to clone your repository.

{% include "../../_common/important-ssh_access.adoc" %}

Let’s get started!

Note	Quick Links Step 1: Enter the SSH Git Clone URL Step 2: Add the SSH Key to Your GitHub Account

Step 1: Enter the SSH Git Clone URL

Within the main page of your repository, look for the green Clone or Download button and click it to reveal a dropdown window. Click on Use SSH.

With SSH selected, copy the SSH URL by clicking the copy to clipboard button.

Head over to dashboard, visit Select source and choose SSH.

Paste the SSH URL you copied into the Git clone URL field.

Step 2: Add the SSH Key to Your GitHub Account

Highlight and copy the generated SSH key.

Navigate to your GitHub Account by first selecting your account photo, and then selecting Settings.

In the left navigation, select SSH keys.

Next, select Add SSH key.

Enter Buddybuild as the title, and paste the copied SSH key into the key field.

Next, click Add key.

Warning

Private git submodules and private cocoapods If your project depends on any code in other private git repos, the SSH key needs to be added to those repos as well.

Navigate back to buddybuild and click on the Build button.

Buddybuild will checkout your project code and kick off a simulator build. The build should finish within a few seconds.

That’s it. You’re now connected to buddybuild. The next step is to invite testers to try out your App.