GitHub

Getting started

Bitrise is powerful and complex - but getting started is easy and intuitive! You can kick off your first build within minutes of signing up. Let’s go over what you need to do to make that happen!

Signing up to Bitrise

First of all, you need a Bitrise account. Choose one of the following to sign up:

Signing up with either of the Git service providers means you connect your Bitrise account to your account on that service provider. With a connected account, you can easily grant Bitrise access to any of your repositories on that account.

After signing up, you can connect your Bitrise account to all of the three supported Git service providers. For example, after you signed up with GitHub, you can connect your Bitrise account to both your GitLab and Bitbucket accounts, too, and access any repositories you have on those accounts.

Trial after signing up

If you sign up for a free account, you will automatically be granted a two-week trial on our Developer plan. This includes:

  • 45 minutes of build time
  • 1000 builds a month
  • a maximum of 100 team members

Read more about the available plans on the Pricing page!

Adding apps

Adding a new app to Bitrise means that you connect a specific repository to Bitrise, allowing us to clone the repository and then build it.

Add a new app any time by clicking the + symbol on the top menu bar and then selecting Add app from the dropdown menu.

Adding a new app

As part of the initial configuration process, you:

You can change all this later - and anyway, adding a new app takes a couple of minutes so you can always just do the process from scratch.

As part of the process, Bitrise will scan and validate your repository and set up an app configuration based on the results of the scan: we can detect the platform type of your app based on the configuration files. If the validation fails, you can set up the app manually.

Read the details of the process in our Adding a new app guide.

Webhooks and triggers

You can set up webhooks as part of the process of adding a new app, or at any time later. Webhooks allow Bitrise to communicate with third party services: for example, a Bitrise webhook set up on a GitHub repository allows Bitrise to start a build automatically when code is modified in the repository.

Once webhooks are set up, configure when to start builds automatically by defining triggers. You can set:

This means that you can, for example, set up a trigger that starts a build when a pull request is opened to the master branch.

Webhooks are required for triggers to work! Read more about webhooks in our Webhooks guide and about triggers in our Triggering builds guide.

Builds and workflows

Once you added an app, your first build will be kicked off automatically. To view your builds, go to your Dashboard - which is the first page once you log in to Bitrise -, select the app and click on the Builds tab to access your builds.

A build is a series of jobs, executed in the order defined in the app’s Workflow Editor. The jobs are called Steps, which represent blocks of script execution. The Steps can be arranged on the graphical UI of the Workflow Editor and they can do a huge number of things: clone your repository, build your app, run tests, pass values to each other, send notification messages to developers.

Read more about Workflows and Steps in our relevant guides:

A build’s logs can be viewed on the build’s page: go to the Builds tab and select the build you want.

All builds run in clean virtual machines that are discarded after the build is complete. Read more about them in our Virtual machines guide.

Teams and organizations

Once you set up a new app, you can start inviting team members. If you have a Developer or an Organization plan, you can have unlimited team members! Only members of an app’s team can view a private app, including its logs. For public apps, anyone can view the build logs who has the URL to the build.

You can also create organizations if you are on one of our Organization plans. Organizations allow you to manage entire teams quickly and effectively.

Testing and deployment

Testing your app and deploying your app are both done with the help of our Steps: we have Steps dedicated to both these functions, based on the platform type. Unit testing, UI testing, and real device testing are all possible on Bitrise.

Once your app is tested, built and ready to go, you can quickly deploy it to the store of your choice, for example, Google Play or the App Store.