Git Integration¶

Capawesome Cloud offers Git integration for Live Updates, allowing you to link your uploaded bundles to specific Git commits, branches, or tags. This integration helps you track changes, versions, and updates of your app more effectively.

Enable Git integration¶

To enable Git integration, simply connect your Git repository to your Capawesome Cloud app in the Capawesome Cloud Console by navigating to the Git page of your app and selecting your Git provider and repository.

Upload a bundle with Git reference¶

When uploading a bundle using the Capawesome CLI, you can now specify the Git reference (branch, tag, or commit hash) that the bundle should be linked to using the --git-ref option. For example, to upload a bundle and link it to the main branch, you can use the following command:

npx @capawesome/cli apps:liveupdates:upload --git-ref main

Capawesome Cloud will then fetch the necessary information from your connected Git repository and associate the uploaded bundle with the specified Git reference.

We recommend using a CI/CD pipeline to automate the creation of bundles and linking them to Git commits. For example, you can use the following step in a GitHub Actions workflow to set the Git reference to the current commit SHA:

- name: Create a bundle on Capawesome Cloud
  run: |
    npx @capawesome/cli apps:liveupdates:upload \
      --app-id 00000000-0000-0000-0000-000000000000 \
      --path www \
      --git-ref ${{ github.sha }}