--- description: Use GitHub Actions to build your web assets and create bundles on Capawesome Cloud using the Capawesome CLI. title: Integrate Capawesome Cloud with GitHub Actions - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/integrations/github-actions.png --- [ Skip to content](#github-actions) [ 🎉 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/) * [ Grafana Faro ](/docs/plugins/grafana-faro/) * [ 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/) * [ Navigation Bar ](/docs/plugins/navigation-bar/) * [ 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 * Integrations * [ Workflow ](#workflow) * [ GitLab CI/CD ](/docs/cloud/live-updates/integrations/gitlab-ci/) * [ 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 * [ Workflow ](#workflow) # GitHub Actions[¶](#github-actions "Permanent link") You can easily publish Live Updates to Capawesome Cloud using [GitHub Actions](https://github.com/features/actions). In this guide, we will show you how to create a GitHub Action workflow that builds your web assets and creates a bundle on Capawesome Cloud using the [Capawesome CLI](/docs/cloud/cli/). ## Preparation[¶](#preparation "Permanent link") Before you start, make sure you have a Capawesome Cloud account and an app set up. Next, you need to create a Capawesome Cloud token and add it to your GitHub repository as an encrypted secret. ### Create a Capawesome Cloud token[¶](#create-a-capawesome-cloud-token "Permanent link") Create a new Capawesome Cloud token via the [Capawesome Cloud Console](https://console.cloud.capawesome.io/settings/tokens). Just navigate to the `Tokens` page in the settings and click on the `Create Token` button. Choose a name for the token and click on the `Create` button. The token is now copied to your clipboard. ### Create a GitHub Secret[¶](#create-a-github-secret "Permanent link") Add the Capawesome Cloud token to your GitHub repository as an encrypted secret with the name `CAPAWESOME_CLOUD_TOKEN` as described in [Creating encrypted secrets for a repository](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions#creating-encrypted-secrets-for-a-repository). ## Workflow[¶](#workflow "Permanent link") ### Create the Workflow[¶](#create-the-workflow "Permanent link") Create a new GitHub Actions workflow file in your repository under `.github/workflows/deploy-live-update.yml` with the following content: `[](#%5F%5Fcodelineno-0-1)name: Deploy Live Update [](#%5F%5Fcodelineno-0-2) [](#%5F%5Fcodelineno-0-3)on: [](#%5F%5Fcodelineno-0-4) workflow_dispatch: [](#%5F%5Fcodelineno-0-5) inputs: [](#%5F%5Fcodelineno-0-6) channel: [](#%5F%5Fcodelineno-0-7) description: 'Channel' [](#%5F%5Fcodelineno-0-8) required: true [](#%5F%5Fcodelineno-0-9) [](#%5F%5Fcodelineno-0-10)jobs: [](#%5F%5Fcodelineno-0-11) deploy: [](#%5F%5Fcodelineno-0-12) name: Build web assets [](#%5F%5Fcodelineno-0-13) runs-on: ubuntu-latest [](#%5F%5Fcodelineno-0-14) steps: [](#%5F%5Fcodelineno-0-15) - name: Checkout [](#%5F%5Fcodelineno-0-16) uses: actions/checkout@v4 [](#%5F%5Fcodelineno-0-17) - name: Set up Node.js 20 [](#%5F%5Fcodelineno-0-18) uses: actions/setup-node@v4 [](#%5F%5Fcodelineno-0-19) with: [](#%5F%5Fcodelineno-0-20) node-version: 20 [](#%5F%5Fcodelineno-0-21) - name: Install Dependencies [](#%5F%5Fcodelineno-0-22) run: npm ci [](#%5F%5Fcodelineno-0-23) - name: Build web assets [](#%5F%5Fcodelineno-0-24) run: npm run build [](#%5F%5Fcodelineno-0-25) - name: Install Capawesome CLI [](#%5F%5Fcodelineno-0-26) run: npm install -g @capawesome/cli@latest [](#%5F%5Fcodelineno-0-27) - name: Create a channel on Capawesome Cloud [](#%5F%5Fcodelineno-0-28) run: npx @capawesome/cli apps:channels:create --app-id 00000000-0000-0000-0000-000000000000 --name ${{ github.event.inputs.channel }} --ignore-errors [](#%5F%5Fcodelineno-0-29) env: [](#%5F%5Fcodelineno-0-30) CAPAWESOME_CLOUD_TOKEN: ${{ secrets.CAPAWESOME_CLOUD_TOKEN }} [](#%5F%5Fcodelineno-0-31) - name: Create a bundle on Capawesome Cloud [](#%5F%5Fcodelineno-0-32) run: npx @capawesome/cli apps:liveupdates:upload --app-id 00000000-0000-0000-0000-000000000000 --path dist --channel ${{ github.event.inputs.channel }} [](#%5F%5Fcodelineno-0-33) env: [](#%5F%5Fcodelineno-0-34) CAPAWESOME_CLOUD_TOKEN: ${{ secrets.CAPAWESOME_CLOUD_TOKEN }} ` This workflow will build your web assets, log in to Capawesome Cloud, create a channel (if it does not exist yet), and create a bundle for the specified channel. ### Trigger the Workflow[¶](#trigger-the-workflow "Permanent link") You can run the workflow manually by navigating to the `Actions` tab in your repository and clicking on the `Deploy Live Update` workflow. You will be prompted to enter the channel name. Of course, you can also trigger the workflow automatically by using a different event trigger like `push` or `pull_request`. January 24, 2026 Back to top