Automate Capgo Live Updates from Lovable with GitHub Actions

あなたのクライアントは、Lovableに1つのボタンを導入したいと思っています。 それは、すべてのアクティブユーザーに変更を配信するものです。 すでに、更新パスが手動で動作することを証明しています:

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

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

Capgoのクライアントは一度だけ行う必要がある手動セットアップの内容をカバーするこのガイドでは、 CAPGO_TOKEN as a GitHub secret. For the workflow file, copy-paste the ready AI instruction into Lovable (Step 3).

パイプラインのしくみ

SSH、ローカルCLI、秘密の設定後に追加のクリックは必要ない

前提条件

• GitHubに接続されているLovableプロジェクト__CAPGO_KEEP_0__のexportガイド)
• Capacitor + @capgo/capacitor-updater __CAPGO_KEEP_0__のリポジトリLovableからモバイルまでのガイド)
• Capgoにアプリを登録し capacitor.config.ts 正しい__CAPGO_KEEP_0__を指す appId
• production ユーザーが実行するビルドとチャンネルがリンクされている

Why --auto-bump

Every Capgo upload needs a 新しい一意のバンドルバージョン. Lovable Publish はバージョンを自動で増分しないため、CI は同じバージョンを使用した場合に 2 回目のデプロイで失敗します。 package.json 最新バージョンをチャンネル (またはアプリ) から読み取り、インクリメントします。デフォルトのレベルは

--auto-bump . または minorを指定します。 --auto-bump patch or --auto-bump major Capacitor のライブアップデートの代替手段

ステップ 1 — Capgo Capgo API キーを作成

1. Open console.capgo.app/apikeys/
2. APIでアプリ用のバンドルアップロードの権限を持つキーを作成してください。
3. __CAPGO_KEEP_0__の値を1度コピーしてください。値はもう一度見ることはできません。

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

ステップ2 — 追加 CAPGO_TOKEN GitHub (環境変数のステップでしか使用しない)

このステップは、クルデープとリポジトリの所有者に送るステップです。

1. GitHubのリポジトリを開いてください。Lovableが同期しているリポジトリです。
2. ここに移動してください。 設定 → シークレットと変数 → アクション
3. クリック 新しいリポジトリのシークレット
4. 名前: CAPGO_TOKEN
5. 値: ステップ 1 から Capgo API キーを貼り付けてください
6. 保存

GitHub はシークレットをワークフローにインジェクトします。 ${{ secrets.CAPGO_TOKEN }}GitHub Actions のワークフローは、以下のようになります。 CAPGO_TOKEN environment variable for the Capgo CLI.

__CAPGO_KEEP_0__ にキーのみが必要です。Lovable の設定には必要ありません。 their レポジトリ。GitHub 内のキーだけが必要です。Lovable の設定には含めないでください。

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

ステップ 3 — Lovable にこのプロンプトを貼り付けます。 main、置換 main ワークフローにブランチ名を追加してください。

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.

変更を適用した後、Lovableのチャットで 公開 ワークフローがGitHubに到着するように

手動代替

Lovableのチャットを使用しない場合は、 .github/workflows/capgo-live-updates.yml YAMLのみ (プロンプトの文章ではない) を使用して、次の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 パス: LovableのViteアプリはよく base: './' に vite.config.ts Capgoのライブアップデートを、愛すべきGitHub Actionsから自動化する base: './'ユーザーがOTAアップデート後に白い画面を表示した場合、Lovableに再度

公開するように求め、ワークフローを再デプロイするようにしてください。 暗号化されたバンドル: Capgo, add CAPGO_PRIVATE_KEY as a second GitHub 秘密とパス --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" 2番目の__CAPGO_KEEP_0__シークレットを追加し、

アップロードステップで

1. を渡してください。
2. Click Publish
3. On GitHub, GitHub を開きます。 Actions と Capgo Live Updates
4. コンテキスト: Live updates product page. 役割: 短い UI ラベルまたはナビゲーションアイテム。 表示される場所: page live-update.astro。 Capgo の製品/ブランドと開発者用語を完全に保持すること。 メッセージキー `live_update_hero_badge` (Live Update Hero Badge)。 ジョブが緑の場合、Capgo コンソールを開き、チャンネルで新しいバンドルが表示されていることを確認します。 __CAPGO_KEEP_0__ をインストールしたデバイスで、変更が到着することを確認します (チャンネル設定に応じて 1 分かかる場合があります)。 production 成功:
5. Publish in Lovable → 緑の __CAPGO_KEEP_0__ Action → __CAPGO_KEEP_1__ に新しいバンドル → ユーザーがアップデートを受け取ります。

✅ トラブルシューティング Lovable → 緑色に表示される GitHub アクション → 新しい Capgo パッケージ → ユーザーがアップデートを受け取る

Troubleshooting

API GitHub GitHub Actions統合.

CLI

npm

1. bun すでにLovableをGitHubに接続し、モバイルアプリでCapgoを設定済みです。
2. 彼らは GitHubシークレットを追加します: CAPGO_TOKEN Capgo APIキー (apikeysページ).
3. 彼らは クリック LovableでPublish 彼らは
4. ローカルで実行しません npx @capgo/cli それは、ユーザーが変更を受け取るようにしたいときに、Publishボタンをクリックするだけのシングルクリック体験に合致しています。

Lovableから単一クリックで実行されるように求めていました: そのボタンは「Lovableに公開する」です。残りはGitHubアクションとCapgoが処理します。

続ける

• iOSとAndroidへの変換 — 全体的なCapacitor + Capgo設定が必要です。アプリをWrapしていない場合は
• GitHub Actionsによる自動ビルドとリリース — タグベースのリリースとバージョンアップ
• GitHub Actionsの統合 — 多チャンネルとPRプレビュー チャンネル
• Capgo Live Updates __CAPGO_KEEP_0__ Live Updates