---
title: Trigger Builds on Branch Pushes
description: Automatically trigger a Capawesome Cloud build whenever you push to a branch, using pattern matching to target specific branches.
---

# Trigger on Branch Pushes

A branch automation starts a build every time you push to a matching branch. It's the right choice for continuous builds — for example, a fresh QA build on every push to `main`, or a build for each of your `release/*` branches — so the latest code is always built without anyone clicking a button.

## Create the automation

1. Open the [Automations](https://console.cloud.capawesome.io/apps/_/automations){:target="_blank"} page and click **Create automation**.
2. Set the **Trigger type** to **Branch**.
3. Set the **Trigger pattern** to the branch name to match. A pattern can be an exact name like `main`, or a glob like `release/*` to match every release branch. See the [pattern syntax](reference.md#trigger-pattern-syntax) for all options.
4. Choose the **Platform** (Android, iOS, or Web) and any [build settings](attach-build-settings.md).

Every push to a matching branch now starts a build. Capawesome Cloud registers a webhook on your repository automatically — see [Set up the Git webhook](webhooks.md) if you ever need to configure it manually.

## Narrow down which pushes build

Branches can be busy, and you won't want a build for every commit. To skip some pushes, add a [commit-message filter](filter-by-commit-message.md) — for example, to skip documentation-only commits with `[skip ci]`, or to build only when the message matches a pattern.

## Next steps

- [Attach build settings](attach-build-settings.md) — sign, configure, and target the triggered builds.
- [Filter by commit message](filter-by-commit-message.md) — control exactly which pushes build.
- [Auto-publish a Live Update](auto-publish-live-update.md) — turn a branch automation into an over-the-air release pipeline.
