Automate Capgo Live Updates dari Lovable dengan GitHub Actions

Klien Anda ingin tombol tunggal di Lovable yang mengirimkan perubahan ke setiap pengguna aktif. Anda sudah membuktikan jalur pembaruan manual bekerja:

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

Bagian yang hilang bukanlah perintah terminal lain di dalam Lovable. Lovable tidak dapat menjalankan Capgo pada Publikasi. Ketika GitHub sinkronisasi diaktifkan, Publikasi mengirimkan komit ke repositori Anda. GitHub Aksi menjalankan build dan bundle upload untuk Anda.

Guid ini membahas setup manual yang harus dilakukan klien Anda sekali: menambahkan CAPGO_TOKEN sebagai GitHub rahasia. Untuk file aliran kerja, salin-pisahkan instruksi AI yang siap ke Lovable (Langkah 3).

How Cara Kerja Pipa

Langkah	Siapa	Apa yang Terjadi
1	Pengguna	Mengedit aplikasi di Lovable dan mengklik Publish
2	Lovable	Commit dan push ke GitHub (biasanya `main`)
3	GitHub Actions	`npm ci`, `npm run build`, `bundle upload --auto-bump` ke Capgo
4	Capgo	Perangkat aktif di `production` saluran menerima pembaruan

Tidak perlu SSH, tidak perlu CLI, tidak perlu klik tambahan setelah rahasia sudah diatur.

Prerequisites

Projek yang disukai terhubung ke GitHub (Petunjuk ekspor)
Capacitor + @capgo/capacitor-updater di repositori (Petunjuk Lovable ke mobile)
Aplikasi terdaftar di Capgo dengan capacitor.config.ts mengarah ke saluran yang benar appId
production Saluran ada dan terhubung ke build yang digunakan pengguna

Mengapa `--auto-bump`

Setiap unggahan Capgo memerlukan versi bundle unik baru. Lovable Publish tidak akan meningkatkan package.json untuk Anda, sehingga CI akan gagal pada deploy kedua jika Anda menggunakan versi yang sama.

--auto-bump Membaca versi terbaru di saluran (atau aplikasi) dan meningkatkannya. Level default adalah minor. Anda dapat melewati --auto-bump patch atau --auto-bump major jika Anda lebih suka.

Langkah 1 — Buatlah kunci Capgo API

Open console.capgo.app/apikeys/
Buatlah kunci API dengan izin untuk mengunggah bundle untuk aplikasi Anda
Salinlah kunci tersebut sekali. Anda tidak akan melihat nilai lengkapnya lagi

Tangani kunci tersebut seperti kata sandi. Jangan pernah memasukkannya ke Git atau memasukkannya ke obrolan Lovable

Langkah 2 — Tambahkan `CAPGO_TOKEN` dalam GitHub (langkah lingkungan yang satu-satunya)

Langkah ini adalah yang dikirimkan kepada Kuldeep dan setiap klien yang memiliki repositori.

di GitHub (langkah env tunggal saja)
Pergi ke Settings → Rahasia dan Variabel → Pengaturan
Click Repository rahasia baru
Nama: CAPGO_TOKEN
Nilai: tempel kunci Capgo API dari Langkah 1
Simpan

GitHub memasukkan rahasia ke dalam aliran kerja sebagai ${{ secrets.CAPGO_TOKEN }}. The workflow below reads it as the CAPGO_TOKEN variabel lingkungan untuk Capgo CLI.

repo mereka. Anda hanya memerlukan kunci di __CAPGO_KEEP_0__, bukan di pengaturan Lovable. their repo. Anda hanya membutuhkan kunci di GitHub, bukan di pengaturan Lovable.

Langkah 3 — Salin prompt ini ke Lovable

Salin blok di bawah ini ke obrolan Lovable. Jika cabang default Anda tidak main, ganti main dalam aliran kerja dengan nama cabang Anda.

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.

Setelah Lovable menerapkan perubahan, klik Publikasikan sehingga aliran kerja mendarat di GitHub.

Alternatif manual

Jika Anda lebih suka tidak menggunakan obrolan Lovable, buat .github/workflows/capgo-live-updates.yml dengan YAML ini saja (bukan prosa prompt). Sesuaikan langkah instalasi/bangun dengan cara yang sama seperti aturan-aturan di atas jika proyek Anda berbeda, lalu komit dan 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: Aplikasi Vite Lovable sering memerlukan base: './' dalam vite.config.ts Jadi aset muat di dalam shell native. Jika pengguna melihat layar putih setelah pembaruan OTA, minta Lovable untuk mengatur base: './'publikasi lagi, dan biarkan workflow meredeploy.

Bundle yang Dikripsi: If you use Capgo pengenkripsi, tambahkan CAPGO_PRIVATE_KEY sebagai rahasia GitHub kedua dan kirimkan --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" pada langkah unggah.

Langkah 4 — Konfirmasi Publikasi mengaktifkan redeploy

Buat perubahan kecil yang dapat dilihat (misalnya teks label tombol)
Click Publish
On GitHub, buka Actions dan lihat Capgo Pembaruan Hidup
Ketika pekerjaan berwarna hijau, buka Capgo konsol dan konfirmasi sebuah bundle baru di production Pengaturan
Pada perangkat dengan aplikasi yang terpasang, konfirmasikan perubahan tersebut (mungkin membutuhkan waktu satu menit tergantung pada pengaturan saluran)

✅ Pengaturan Publikasikan di Lovable → hijau GitHub Aksi → bundle baru di Capgo → pengguna mendapatkan update.

Troubleshooting

Gejala	Penyebab yang mungkin	Fix
Aliran kerja tidak pernah berjalan	Push pergi ke cabang lain dari `main`	Perubahan `branches` di aliran kerja atau publikasikan ke `main`
`CAPGO_TOKEN` / error autentikasi	Rahasia hilang atau nama salah	Rahasia harus tepat `CAPGO_TOKEN` di bawah rahasia Actions
Version already exists	Upload menggunakkan versi bundle yang sama lagi	Simpan `--auto-bump` di langkah unggah (atau lewati) `--auto-bump patch`)
Build gagal pada `npm ci`	Lockfile tidak sinkron	Jalankan `npm install` lokal, commit `package-lock.json`Upload berhasil, layar putih
Upload berhasil, layar putih	atau Vite `webDir` Match `base`	Match `capacitor.config.ts` `webDir` untuk membangun output (`dist` untuk Vite) dan atur `base: './'`
Pengguna tidak melihat update	Saluran tidak terkait dengan pembangunan mereka	Dalam Capgo, hubungkan pembangunan perangkat ke `production` atau atur saluran menjadi publik

Untuk pola kerja aliran lainnya (cabang fitur, saluran PR, enkripsi), lihat GitHub Integrasi Actions.

Apakah yang Anda sampaikan kepada klien

Kirimkan daftar periksa ini:

Anda Sudah terhubung Lovable ke GitHub dan mengatur Capgo di aplikasi mobile.
Mereka menambahkan satu rahasia GitHub: CAPGO_TOKEN dengan kunci Capgo API mereka (halaman apikeys).
Mereka klik Publish dalam Lovable ketika mereka ingin pengguna menerima perubahan.
Mereka tidak pernah menjalankan npx @capgo/cli lokal kecuali mereka ingin.

Hal itu sesuai dengan pengalaman satu-klik yang mereka minta: Publish di Lovable adalah tombol; GitHub Actions dan Capgo mengelola sisanya.

Teruskan

Mengonversi Lovable ke iOS dan Android — Konfigurasi lengkap Capacitor + Capgo jika Anda belum menggabungkan aplikasi
Pembangunan dan rilis otomatis dengan GitHub Actions — Rilis berdasarkan tag dan peningkatan versi
GitHub Actions integrasi — Saluran multi dan pratinjau saluran PR
Capgo Pembaruan Hidup — Saluran, rollback, dan statistik adopsi

Mengaktifkan Capgo Live Update dari Lovable dengan GitHub Actions