GitHub

Creating white label app versions

This guide explains how to create different versions of your white label project and build all or just one version by chaining Workflows and setting differences in Environment Variables.

In this article, we’re building three individual versions (red, green, white) of our white label project.

What you’ll need for this setup:

Prepping Workflows of a white label app

  1. Add your app to Bitrise in the usual way.
  2. Click your app on the Dashboard and go to Workflows.
  3. Next to WORKFLOW, click + Workflow to create your main Workflow.
  4. Add a new Workflow based on an Empty Workflow.

    In this example, our main Workflow is called allcolor. This Workflow will start running your version-specific Workflows in the chain.

  5. Click + Workflow to create your version-specific Workflow.

    Keep adding as many Workflows as many different versions you wish to create.

  6. Click the Env Vars tab and add your version-specific parameters to each Workflow you’ve just created.

    As you can see in this image we’re adding Workflow Environment Variables to our green, red and white Workflows but leaving allcolor intact.

  7. Go back to the Workflows tab and click Workflow to create your utility Workflow.

    Make sure you give a name that starts with an underscore, for example, _runner, otherwise Bitrise CLI will not treat it as a utility Workflow.

  8. Add Steps to your utility Workflow.

    In this example, we’re adding a Script Step which will inherit the Environment Variable from the Workflows and print out the value in the build log.

Chaining Workflows

Now that we have a bunch of Workflows ready, it’s time to chain them together in the right order.

  1. Select your main Workflow (allcolor in this example) that is responsive to triggers.
  2. Click Add Workflow after, select the version-specific Workflow, and hit Done.
  3. Click Add Workflow after again and add the utility Workflow right after the version-specific Workflow.

    Keep adding Workflows depending on how many versions you’d like to build. In this guide, we’re adding 3 different types of Workflows after allcolor where each Workflow is followed by the same utility Workflow.

    This is what the setup looks like on the Workflows tab.

  4. Go back to your Build’s page and click Start/Schedule a build.
  5. In the Build configuration pop-up window, select your main Workflow under Workflow. This will kickstart your chained Workflows and build the app versions of your white label app.

In our simple example, here is the output of the chained Workflows:

Parallel running Workflows

If you add the Bitrise Start Build Step to your main Workflow, it will run all your Workflows parallel, whereas without the Step your Workflows will run consecutively.