クライアントは、Lovableのボタン1つで全アクティブユーザーに変更を配信したいと考えています。更新フローが手動で動くことはすでに確認済みです:
npx @capgo/cli@latest bundle upload --channel=production --auto-bump
足りないのは、Lovable内で実行する別のターミナルコマンドではありません。 LovableはPublish時にCapgoを実行できません。 GitHubの同期が有効な場合、 Publishはリポジトリにコミットをプッシュします. GitHub Actionsがビルドを実行し、 bundle upload あなたの代わりに行います。
このガイドでは、クライアントが一度だけ行う必要がある唯一の手動設定、つまり CAPGO_TOKEN GitHub secretとして追加する方法を説明します。ワークフローファイルについては、すぐに使えるAIへの指示をLovableにコピー&ペーストしてください(ステップ3)。
パイプラインの仕組み
| ステップ | 誰が | 何が起きるか |
|---|---|---|
| 1 | クライアント | Lovableでアプリを編集し、 公開 |
| 2 | Lovable | GitHub へのコミットとプッシュ(通常 main) |
| 3 | GitHub アクション | npm ci, npm run build, bundle upload --auto-bump Capgo へ |
| 4 | Capgo | チャネル上のアクティブデバイス production が更新を受信します |
SSHもローカルのCLIも不要。シークレット設定後は追加のクリックも不要です。
前提条件
- GitHub に接続された Lovable プロジェクト (エクスポートガイド)
- Capacitor +
@capgo/capacitor-updaterリポジトリ内(Lovableアプリのモバイル化ガイド) - Capgo に登録済みのアプリで、
capacitor.config.ts正しいappId productionchannel を指しており、ユーザーが実行するビルドと紐付いている必要があります。
理由 --auto-bump
すべての Capgo アップロードには、 新しい一意の bundle バージョンが必要です。Lovable Publish はバージョンを自動で package.json 上げてくれないため、同じバージョンを再利用すると 2 回目のデプロイで CI が失敗します。
--auto-bump は、channel(または app)の最新バージョンを読み取ってインクリメントします。デフォルトのレベルは minorです。以下のように指定できます。 --auto-bump patch または --auto-bump major もしよろしければ。
ステップ 1 — Capgo API キーを作成する
- 開く console.capgo.app/apikeys/
- アプリの bundle を upload する権限がある API キーを作成します
- キーは一度だけコピーしてください。完全な値は二度と表示されません。
このキーはパスワードと同じように扱ってください。Git に commit したり、Lovable のチャットに貼り付けたりしないでください。
ステップ 2 — 追加 CAPGO_TOKEN GitHub 内(唯一の env ステップ)
これは Kuldeep と、リポジトリを所有するクライアントに送るステップです。
- Lovable が同期する GitHub リポジトリを開きます
- 以下に移動します: 設定 → Secrets と変数 → アクション
- クリック 新しいリポジトリ Secret
- 名前:
CAPGO_TOKEN - 値: ステップ1の Capgo API キーを貼り付けてください
- 保存
GitHub はシークレットをワークフローに以下のように注入します ${{ secrets.CAPGO_TOKEN }}。以下のワークフローはこれを CAPGO_TOKEN 環境変数として Capgo CLI に読み取ります。
リポジトリがクライアントの組織内にある場合、クライアントが 自身の リポジトリにシークレットを追加する必要があります。Lovable の設定ではなく、GitHub のキーだけが必要です。
ステップ 3 — このプロンプトを Lovable に貼り付ける
以下のブロックを 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のみを使用してください(プロンプトの文章ではありません)。プロジェクト構成が異なる場合は、上記のルールに従ってinstall/buildの手順を調整し、commitしてpushしてください。
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: './' における vite.config.ts ネイティブシェル内でアセットを読み込むためです。OTAアップデート後に画面が白くなる場合は、Lovableに以下を設定するよう依頼してください: base: './'、再度publishを行い、ワークフローによる再デプロイを待ってください。
暗号化されたbundle: 以下を使用する場合は、 Capgo 暗号化を CAPGO_PRIVATE_KEY 2つ目の GitHub secretとして追加して渡し、 --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" アップロードステップで。
ステップ4 — Publishトリガーによるデプロイの確認
- Lovableで、目に見える小さな変更(例: ボタンのラベルテキスト)を行います
- クリック 公開
- GitHubで、 アクション を開いて Capgo Live Update
- ジョブがグリーンになったら、 Capgoコンソール で新しいbundleを確認します
productionチャンネル - アプリをインストール済みのデバイスで、変更が反映されたことを確認してください(チャンネル設定により1分ほどかかる場合があります)
✅ 成功: LovableでPublish → 緑の GitHub Action → Capgoに新しいbundle → ユーザーにアップデートが届く。
トラブルシューティング
| 症状 | 考えられる原因 | 解決策 |
|---|---|---|
| ワークフローが実行されない | プッシュ先が指定のブランチ以外になっている main |
変更内容 branches ワークフロー内、またはpublish先の main |
CAPGO_TOKEN / 認証エラー |
Secretが未設定か、名前が間違っています | Secretは完全一致で CAPGO_TOKEN Actions secrets の下に |
| バージョンは既に存在します | アップロードで同じbundleバージョンが再利用されました | 保持 --auto-bump アップロードステップで (または渡す) --auto-bump patch) |
Buildが失敗する npm ci |
Lockfileが同期していません | 実行 npm install ローカルでcommit package-lock.json, 再公開する |
| アップロード成功、白画面 | 誤り webDir または Vite base |
合わせる capacitor.config.ts webDir をビルド出力に (dist Vite の場合) に設定します base: './' |
| ユーザーにアップデートが表示されません | Channel がビルドに紐付けられていません | Capgo で、デバイスのビルドを Channel にリンクします production または Channel を public に設定します |
その他のワークフローパターン (feature branch、PR Channel、暗号化) の詳細はこちら GitHub Actionsとの連携.
クライアントに伝える内容
このチェックリストを送ってください:
- お客様 LovableをGitHubに接続し、モバイルアプリにCapgoを設定済みであること。
- クライアントは GitHubのsecretを1つ追加します:
CAPGO_TOKENCapgoのAPIキーを使って(apikeysページ)). - クライアントは クリックして 公開 Lovable で、ユーザーに変更を届けたいタイミングで。
- ローカルで実行するのは
npx @capgo/cli必要があるときだけです。
これは、彼らが求めていたワンクリック体験に合致しています。Lovable での Publish がボタンであり、GitHub Actions と Capgo が残りを処理します。
次へ進む
- LovableをiOSとAndroidに変換する — アプリがまだラップされていない場合の、完全な Capacitor + Capgo セットアップ
- GitHub Actions を使用したビルドとリリースの自動化 — タグベースのリリースとバージョンアップ
- GitHub Actionsとの連携 — マルチチャネルとPRプレビューチャネル
- Capgo Live Update — チャネル、ロールバック、採用統計