Skip to content

Getting Started

In this guide, you will learn how to create your first automation using Capawesome Cloud.

Prerequisites

Before you begin, ensure you have:

Step 1: Navigate to Automations

Navigate to the Automations page of your app in the Capawesome Cloud Console.

Step 2: Create an Automation

Click on the Create Automation button and configure the following properties:

  • Name: A display name to identify the automation.
  • Platform: The target platform — Android, iOS, or Web.
  • Trigger Type: The Git event that triggers the build — Branch (triggers on push to a branch) or Tag (triggers on tag creation).
  • Trigger Pattern: The branch or tag name to match. For example, main to trigger on pushes to the main branch, or v* to trigger on tags starting with v.
  • Commit Message Pattern (optional): A pattern to filter triggers based on the commit message content.

Step 3: Configure Build Settings (Optional)

You can optionally configure additional build settings for the automation:

  • Build Type: The type of build to create (see Build Types).
  • Build Stack: The build stack to use (see Build Stacks).
  • Signing Certificate: The signing certificate for the build (see Signing Certificates).
  • Environment: The environment variables for the build (see Environments).
  • Destination: The publish destination for the build artifact (see Store Destinations).
  • Channel: The live update channel to deploy to (see Channels).

Step 4: Verify Webhook Setup

When you create an automation, Capawesome Cloud automatically registers a webhook on your connected Git repository. This webhook listens for the configured Git events and triggers builds accordingly.

If automatic registration fails, you can configure the webhook manually. See Webhooks for instructions.

Step 5: Test the Automation

Push a commit or create a tag that matches your trigger pattern and verify that:

  1. The automation's Last triggered timestamp updates on the Automations page.
  2. A new build appears on the Builds page.

Congratulations! You have successfully created your first automation using Capawesome Cloud. 🎉

Managing Automations

After creating an automation, you can manage it from the Automations page:

  • Edit: Update the automation's configuration by clicking on the Edit button.
  • Enable/Disable: Toggle an automation on or off without deleting it. Disabled automations do not trigger builds.
  • History: View the build history for a specific automation by clicking on the History button.
  • Delete: Remove an automation by clicking on the Delete button and confirming the deletion.

Next Steps

  • Webhooks

    Learn how to configure webhooks for your automations.

    Webhooks

  • Build Types

    Learn about different build types available for iOS and Android platforms.

    Build Types

  • Environments

    Use environment variables and secrets to customize your builds.

    Environments

  • Signing Certificates

    Set up signing certificates for production builds on iOS and Android.

    Certificates