Automate Capgo Live Updates from Lovable with GitHub Actions

クライアントは、Lovableに変更をすべてのアクティブユーザーに送信するための単一のボタンが必要です。既にアップデートパスが手動で機能していることを証明しました:

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

欠落しているのは、Lovable内に別のターミナルコマンドではないことです。 LovableではCapgoを実行できません。 GitHubの同期が有効になると、 Publishはリポジトリにコミットをプッシュします. GitHub Actionsはビルドと bundle upload あなたのために実行されます。

このガイドでは、クライアントが一度だけ行う必要がある手動設定をカバーしています: __CAPGO_KEEP_0__シークレットとして追加します。ワークフローファイルの場合、Lovable (ステップ 3) にコピーペーストする用意ができた AI 指示を入力します。 CAPGO_TOKEN as a GitHub secret. For the workflow file, copy-paste the ready AI instruction into Lovable (Step 3).

ステップ

誰	Who	What happens
1	クライアント	Edits the app in Lovable and clicks 公開
2	Lovable	Commits and pushes to GitHub (usually `main`)
3	GitHub (通常	`npm ci`, `npm run build`, `bundle upload --auto-bump` Capgo Actions
4	Capgo	__CAPGO_KEEP_0__ `production` アクティブなデバイス

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

前提条件

LovableプロジェクトがGitHubに接続されている場合exportガイド)
Capacitor + @capgo/capacitor-updater リポジトリ内に(Lovableからモバイルまでのガイド)
AppがCapgoに登録されている capacitor.config.ts 正しい__CAPGO_KEEP_0__へのポインティング appId
production __CAPGO_KEEP_0__チャンネルが存在し、ユーザーが実行するビルドとリンクされている

なぜ `--auto-bump`

Capgoのアップロードごとに新しい一意のバンドルバージョンが必要なぜ. Lovable Publish はバージョンを上げることはありません package.json CI は 2 回目のデプロイで失敗します。同じバージョンを再利用すると

--auto-bump チャンネル (またはアプリ) から最新のバージョンを読み取り、バージョンをインクリメントします。デフォルトのレベルは minor。このバージョンを使用できます --auto-bump patch または --auto-bump major CI は 2 回目のデプロイで失敗します。同じバージョンを再利用すると

Step 1 — Create a Capgo API key

CI は 2 回目のデプロイで失敗します。同じバージョンを再利用すると console.capgo.app/apikeys/
Create an API key with permission to upload bundles for your app
Step 1 — Create a __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ key

Open __CAPGO_KEEP_0__ console.__CAPGO_KEEP_0__.app/apikeys/をオープンします。

ステップ 2 — 追加 `CAPGO_TOKEN` GitHub (環境変数のステップのみ)

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

GitHub リポジトリを開きます。Lovable が同期するもの
Go to 設定 → シークレットと変数 → アクション
クリック 新しいリポジトリシークレット
Name: CAPGO_TOKEN
Value: Step 1 の Capgo API キーをペーストしてください
保存

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

リポジトリ ステップ3—Lovableにこのコマンドを貼り付けます。 repo. You only need the key in GitHub, not in Lovable settings.

ワークフローに自分のブランチ名を置き換えてください。

Lovableが変更を適用した後、 mainクリックしてください。 main in the workflow with your branch name.

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.

After Lovable applies the change, click 公開したがって、ワークフローはGitHubに到着します。

手動代替

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 パス: Viteアプリはよく base: './' に必要です。アセットがネイティブシェル内でロードされるようにするため、ユーザーがOTAアップデート後に白い画面を表示した場合、Lovableに vite.config.ts を設定し、ワークフローを再デプロイしてください。 base: './'暗号化されたバンドル:

Encrypted bundles: あなたが Capgo暗号化を使用 CAPGO_PRIVATE_KEY GitHubの2番目のシークレットを追加してアップロードステップで --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" をパス

ステップ4 — Publishを確認すると、Lovableで

小さな変更を実行 (例: ボタンラベルテキスト)
をクリック Publish
GitHubで アクション をオープンして Capgo Live Updates
ジョブが緑の場合、__CAPGO_KEEP_0__ コンソールを開き Capgo console チャンネル production 成功:
Publish in Lovable → 緑の __CAPGO_KEEP_0__ Action → __CAPGO_KEEP_1__ に新しいバンドル → ユーザーがアップデートを受け取ります。

✅ トラブルシューティング Publish in Lovable → green GitHub Action → new bundle in Capgo → users get the update.

原因

対処法	__CAPGO_KEEP_0__	__CAPGO_KEEP_1__
ワークフローは実行されません	プッシュは他のブランチに移動しました `main`	変更 `branches` ワークフローまたはパブリッシュに `main`
`CAPGO_TOKEN` / auth エラー	シークレットが欠落または名前が間違っています	シークレットは正確に `CAPGO_TOKEN` アクションのシークレット
バージョンはすでに存在します	アップロードは同じバンドルバージョンを再利用しました	__CAPGO_KEEP_0__ `--auto-bump` アップロードステップ (またはパス `--auto-bump patch`)
ビルド失敗 `npm ci`	ロックファイルが同期されていない	実行 `npm install` ローカルでビルド、コミット `package-lock.json`、再度公開
アップロード成功、白い画面	誤った `webDir` またはVite `base`	マッチ `capacitor.config.ts` `webDir` ビルド出力 (`dist` Viteの場合) と設定 `base: './'`
ユーザーは更新を表示できない	チャンネルがビルドにリンクされていない	Capgoで、デバイスのビルドを `production` またはチャンネルを公開に設定する

より多くのワークフローパターン (機能ブランチ、PR チャネル、暗号化) を参照してください GitHub Actions の統合.

コンテキスト: Capgo のソリューションズマーケティングページ。役割: ウェブサイトコピー文。見られる場所: ソリューションズ/ QSR.astro。Capgo の製品/ブランド名と開発者用語をそのまま保存する。

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

以下のチェックリストを送信してください already connected Lovable to GitHub and set up Capgo on the mobile app.
コンテキスト: Capgo のマーケティングウェブサイトの HTML テキストフラグメント (親キー `you_definition` (あなたの定義)). Capgo のマーケティングウェブサイトのページ/エリア: マーケティングまたは法的文書。役割: 長いマーケティングまたは法的文書。見られる場所: page disclaimer.astro、page return.astro。メッセージキー `you_definition` (あなたの定義) すでにLovableをGitHubに接続し、モバイルアプリで__CAPGO_KEEP_1__を設定済み CAPGO_TOKEN with their Capgo API key (APIキーページ).
彼らクリック Lovable では、ユーザーが変更を受け取るようにしたいときにクリックします。 彼らは
ローカルでは実行されません。実行したい場合は実行します。 npx @capgo/cli その一致は、単一クリックのエクスペリエンスを求めていました: Lovable では、Publish ボタン; __CAPGO_KEEP_0__ Actions と __CAPGO_KEEP_1__ は残りを処理します。

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 に変換する

— __CAPGO_KEEP_0__ + __CAPGO_KEEP_1__ の完全なセットアップです。アプリを wrap していない場合は — Full Capacitor + Capgo setup if you have not wrapped the app yet
Automatic build and release with GitHub Actions — リリースタグとバージョンアップ
GitHub Actions統合 — 多チャンネルとPRプレビューチャンネル
Capgo ライブアップデート — チャンネル、ロールバック、採用統計