---
description: Link your bundles to Git commits in Capawesome Cloud to easily track changes, versions, and updates of your app with seamless integration.
title: Git Integration - Capawesome
image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/advanced/git-integration.png
---

[ Skip to content](#git-integration) 

[ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) 

* [  Formbricks ](/docs/plugins/formbricks/)
* [  Geocoder ](/docs/plugins/geocoder/)
* [  Google Sign-In ](/docs/plugins/google-sign-in/)
* [  libSQL ](/docs/plugins/libsql/)
* [  Live Update ](/docs/plugins/live-update/)
* [  Managed Configurations ](/docs/plugins/managed-configurations/)
* [  Media Session ](/docs/plugins/media-session/)
* [  ML Kit ](/docs/plugins/mlkit/)
* [  NFC ](/docs/plugins/nfc/)
* [  OAuth ](/docs/plugins/oauth/)
* [  Pedometer ](/docs/plugins/pedometer/)
* [  Photo Editor ](/docs/plugins/photo-editor/)
* [  PostHog ](/docs/plugins/posthog/)
* [  Printer ](/docs/plugins/printer/)
* [  Purchases ](/docs/plugins/purchases/)
* [  RealtimeKit ](/docs/plugins/realtimekit/)
* [  Screen Orientation ](/docs/plugins/screen-orientation/)
* [  Screenshot ](/docs/plugins/screenshot/)
* [  Secure Preferences ](/docs/plugins/secure-preferences/)
* [  Speech Recognition ](/docs/plugins/speech-recognition/)
* [  Speech Synthesis ](/docs/plugins/speech-synthesis/)
* [  Share Target ](/docs/plugins/share-target/)
* [  Square Mobile Payments ](/docs/plugins/square-mobile-payments/)
* [  SQLite ](/docs/plugins/sqlite/)
* [  Superwall ](/docs/plugins/superwall/)
* [  Torch ](/docs/plugins/torch/)
* [  Wifi ](/docs/plugins/wifi/)
* [  Zip ](/docs/plugins/zip/)
* [  Cloud ](/docs/cloud/)
* [  Live Updates ](/docs/cloud/live-updates/)
* Advanced
* [  Privacy ](/docs/cloud/live-updates/advanced/privacy/)
* [  Rollbacks ](/docs/cloud/live-updates/advanced/rollbacks/)
* [  Rollouts ](/docs/cloud/live-updates/advanced/rollouts/)
* [  Self-Hosting ](/docs/cloud/live-updates/advanced/self-hosting/)
* Integrations
* [  Native Builds ](/docs/cloud/native-builds/)
* [  Configuration ](/docs/cloud/native-builds/configuration/)
* [  Environments ](/docs/cloud/native-builds/environments/)
* Guides
* [  Sample Projects ](/docs/cloud/native-builds/sample-projects/)
* [  Troubleshooting ](/docs/cloud/native-builds/troubleshooting/)
* [  Automations ](/docs/cloud/automations/)
* [  Assist ](/docs/cloud/assist/)
* Account
* Organizations
* [  Organization and User Management ](/docs/cloud/organizations/memberships/)
* [  Single Sign-On (SSO) ](/docs/cloud/organizations/sso/)
* [  Teams ](/docs/cloud/organizations/teams/)
* [  Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/)
* [  Integrations ](/docs/cloud/integrations/)
* [  License Keys ](/docs/cloud/license-keys/)
* [  Webhooks ](/docs/cloud/webhooks/)
* [  Pricing ](https://capawesome.io/pricing/)
* [  FAQ ](/docs/cloud/faq/)
* [  Support ](/docs/cloud/support/)
* [  Contributing ](/docs/contributing/)
* [  LLMs ](/docs/llms/)
* [  Insiders ](/docs/insiders/)
* [  License ](https://capawesome.io/legal/eula/)
* [  Support ](/docs/insiders/support/)
* [  FAQ ](/docs/insiders/faq/)
* [  Blog ](/blog/)
* Categories

# Git Integration[¶](#git-integration "Permanent link")

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[¶](#enable-git-integration "Permanent link")

To enable Git integration, simply connect your Git repository to your Capawesome Cloud app in the Capawesome Cloud Console by navigating to the [Git](https://console.cloud.capawesome.io/apps/%5F/git) page of your app and selecting your Git provider and repository.

## Upload a bundle with Git reference[¶](#upload-a-bundle-with-git-reference "Permanent link")

When uploading a bundle using the [Capawesome CLI](/docs/cloud/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:

`[](#%5F%5Fcodelineno-0-1)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:

`[](#%5F%5Fcodelineno-1-1)- name: Create a bundle on Capawesome Cloud
[](#%5F%5Fcodelineno-1-2)  run: |
[](#%5F%5Fcodelineno-1-3)    npx @capawesome/cli apps:liveupdates:upload \
[](#%5F%5Fcodelineno-1-4)      --app-id 00000000-0000-0000-0000-000000000000 \
[](#%5F%5Fcodelineno-1-5)      --path www \
[](#%5F%5Fcodelineno-1-6)      --git-ref ${{ github.sha }}
`

February 21, 2026 

 Back to top