Automate Capgo Live Updates from Lovable with GitHub Actions

クライアントはLovableに1つのボタンですべてのアクティブユーザーに変更を配信したいと言っています。既にアップデートパスが手動で動作することを証明したのであれば:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump

もう一つのターミナルコマンドは必要ありません。 LovableではCapgoをPublish時に実行できません。 GitHubのsyncが有効になると リポジトリにコミットを公開します。. GitHub Actions はビルドと bundle upload を実行します。

。 CAPGO_TOKEN as a GitHub secret. For the workflow file, copy-paste the ready AI instruction into Lovable (Step 3).

を追加します。

ワークフローファイルの場合、ステップ 3 における Lovable に AI の準備ができた指示をコピー・ペーストしてください。	パイプラインのしくみ	ステップ
1	誰	何が起こるかクライアント
2	Lovable	コミットとGitHubへのプッシュ `main`)
3	GitHubアクション	`npm ci`, `npm run build`, `bundle upload --auto-bump` Capgo
4	Capgo	Capgoにプルリクエストを送信する `production` Capgoにプルリクエストを送信する

No SSH, no local CLI, no extra click after the secret is configured.

アップデートを受け取る

SSH、GitHub、追加のクリックは必要ない必要な前提条件)
Capacitorに接続されたLovableプロジェクト @capgo/capacitor-updater リポジトリ (Lovable からモバイルガイド)
Capgo にアプリを登録 capacitor.config.ts 正しい __CAPGO_KEEP_0__ を指す appId
production チャンネルが存在し、ユーザーが実行するビルドとリンクされている

なぜ `--auto-bump`

Capgo のアップロードには毎回新しいバージョンのバンドルが必要 Lovable Publish はバージョンを自動で増やす機能はありませんCI が 2 回目のデプロイで失敗するのは、同じバージョンを再利用したためです package.json 最新のバージョンをチャンネル (またはアプリ) から読み取り、インクリメントします。デフォルトのレベルは

--auto-bump です。指定したレベルを使用できます minor__CAPGO_KEEP_0__ --auto-bump patch または --auto-bump major もし、あなたが好みます。

ステップ 1 — Capgo API キーを作成します。

開くコンソール.capgo.app/apikeys/
アプリ用にバンドルをアップロードする権限を持つ API キーを作成します。
このキーを1度コピーしてください。再度表示することはできません。

このキーをパスワードのように扱ってください。Gitにコミットしたり、Lovableチャットに貼ったりしないでください。

ステップ 2 — 追加 `CAPGO_TOKEN` GitHub (環境変数のステップ)に追加します。

このステップは、Kuldeepやクライアントがリポジトリを所有している場合に送信します。

GitHub リポジトリをLovableが同期している場所を開きます。
Go to 設定 → シークレットと変数 → アクション
クリック 新しいリポジトリシークレット
名前: CAPGO_TOKEN
値:Step 1のCapgo APIキーを貼り付けてください
保存

GitHubはワークフローにシークレットをインジェクトします。 ${{ secrets.CAPGO_TOKEN }}ワークフローは__CAPGO_KEEP_0__ __CAPGO_KEEP_1__の環境変数として読み取ります。 CAPGO_TOKEN environment variable for the Capgo CLI.

リポジトリがクライアントの組織内にある場合、秘密鍵を追加するのはその組織の担当者が責任を持つ必要があります。その repo. You only need the key in GitHub, not in Lovable settings.

ステップ 3 — Lovable にこのプロンプトを貼り付けます。

Lovable チャットに次のブロックをコピーします。デフォルトブランチが mainに設定されている場合、ワークフローにブランチ名を置き換えてください。 main Lovable が変更を適用した後、

Add Capgo Live Updates CI with GitHub Actions.

Create `.github/workflows/capgo-live-updates.yml` (create folders if needed). Start from this YAML, then adapt install/build to this project while keeping Capgo upload + CAPGO_TOKEN secret behavior:

name: Capgo Live Updates

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: '24'
          cache: 'npm'

      - name: Install and build
        run: |
          npm ci
          npm run build

      - name: Upload bundle to Capgo
        run: npx @capgo/cli@latest bundle upload --channel=production --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Rules:
- Do not hardcode any Capgo API key in the repo or in chat.
- The workflow must read CAPGO_TOKEN only from GitHub Actions secrets (`${{ secrets.CAPGO_TOKEN }}`).
- Keep `--auto-bump` on the upload command so each Publish gets a new unique bundle version.
- Prefer the project's real production build script from package.json (for example `npm run build` or `vite build`).
- If package-lock.json is missing, use `npm install` instead of `npm ci`.
- Do not modify app UI or Capacitor config for this task.
- Commit the workflow file so the next Publish pushes it to GitHub.

をクリックしてワークフローを に公開します。 so the workflow lands on GitHub.

Lovable チャットを使用しない場合は、

ワークフローを手動で更新する必要があります。 .github/workflows/capgo-live-updates.yml この YAML のみ (プロンプトの文章ではありません)。インストール/ビルドのステップを、上記のルールと同様にアダプトする場合は、プロジェクトが異なる場合に限り、コミットしてプッシュしてください。

name: Capgo Live Updates

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: '24'
          cache: 'npm'

      - name: Install and build
        run: |
          npm ci
          npm run build

      - name: Upload bundle to Capgo
        run: npx @capgo/cli@latest bundle upload --channel=production --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Vite base path: Lovable Vite アプリはよく base: './' in vite.config.ts Nativeシェルの内部でアセットが読み込まれるようにする必要があります。ユーザーがOTAアップデート後に白い画面を表示した場合、Lovableに base: './'再度公開し、ワークフローを再デプロイしてください。

暗号化されたバンドル: Capgoで Capgo暗号化を使用している場合、2番目の__CAPGO_KEEP_0__シークレットを追加して CAPGO_PRIVATE_KEY as a second GitHub secret and pass --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" アップロードステップで。

ステップ 4 — Confirm Publishはデプロイをトリガーします

Lovableで、ボタンラベルテキストなどの小さな変更を実行してください
クリック公開
GitHubで開きます アクション __CAPGO_KEEP_0__ライブアップデートを観察 Capgoライブアップデート
ジョブが緑のときは、__CAPGO_KEEP_0__コンソールを開いて、 Capgo console __CAPGO_KEEP_0__コンソール production チャンネル
アプリがインストールされたデバイスで、変更が到着することを確認します (チャンネル設定に応じて 1 分かかる場合があります)

✅ Success: Publish in Lovable → 緑の GitHub Action → 新しい Capgo → ユーザーがアップデートを受け取ります。

トラブルシューティング

症状	原因	修正
ワークフローが実行されない	プッシュがブランチ以外の `main`	変更 `branches` ワークフローまたは公開 `main`
`CAPGO_TOKEN` / 認証エラー	シークレットが欠落しているか、名前が間違っている	シークレットは正確に `CAPGO_TOKEN` アクションのシークレットの下
バージョンはすでに存在する	アップロードは同じバンドルバージョンを再利用した	保持 `--auto-bump` アップロードステップ (またはパスを渡す) `--auto-bump patch`)
ビルドは `npm ci`	ロックファイルが同期されていない	実行 `npm install` ローカルに実行し、コミット `package-lock.json`, 再度公開します。
アップロード成功、白い画面	誤り `webDir` または Vite `base`	一致 `capacitor.config.ts` `webDir` ビルド出力 (`dist` Vite の場合) と設定 `base: './'`
ユーザーは更新を表示しません。	チャンネルがビルドにリンクされていません。	In Capgo, デバイスビルドを `production` またはチャンネルを公開に設定

より多くのワークフローパターン (機能ブランチ、PR チャンネル、暗号化) については、 GitHub Actions integration.

あなたがクライアントに伝えること

以下のチェックリストを送ります

あなた すでにLovableをGitHubに接続し、モバイルアプリでCapgoを設定済みです
彼ら 1つのGitHubシークレットを追加します CAPGO_TOKEN 彼らのCapgoAPIキー (apikeysページ).
彼らクリック公開 CapgoのLovableで、ユーザーが変更を受け取るようにしたい時はいつでも変更を受け取ることができます。
They never run npx @capgo/cli ローカルに実行することはありません。

That matches the single-click experience they asked for: Publish in Lovable is the button; GitHub Actions and Capgo handle the rest.

続けてください。

LovableをiOSとAndroidに変換します。 — まだアプリをwrapしていない場合は、Capacitor + Capgo のフルセットアップが必要です。
Automatic build and release with GitHub Actions — タグベースのリリースとバージョンアップ。
GitHub Actionsの統合ページ/エリア: Capgoのソリューションマーケティングページ。役割: ウェブサイトのコピー文。見られる場所: page solutions/qsr.astro。Capgoの製品/ブランド名と開発者用語をそのまま保存する。
Capgo Live Updates — チャンネル、ロールバック、採用統計