Automasi 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 update 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 Terbitkan. Ketika GitHub sinkronisasi diaktifkan, Publikasikan push ke repositori Anda. GitHub Aksi menjalankan build dan bundle upload untuk Anda.

Panduan ini membahas satu kali setup manual yang harus dilakukan oleh klien: tambahkan CAPGO_TOKEN sebagai rahasia GitHub. Untuk file aliran, salin-pisahkan instruksi AI yang sudah siap ke Lovable (Langkah 3).

Bagaimana pipa kerja

Langkah	Siapa	Apa yang terjadi
1	Klien	Mengedit aplikasi di Lovable dan mengklik Publikasikan
2	Proyek yang disukai	Komit dan push ke GitHub (biasanya) `main`)
3	GitHub Aksi	`npm ci`, `npm run build`, `bundle upload --auto-bump` ke Capgo
4	Capgo	Perangkat aktif di saluran menerima pembaruan `production` Tidak perlu SSH, tidak perlu __CAPGO_KEEP_0__ lokal, tidak perlu klik tambahan setelah rahasia diatur

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

Proyek yang disukai terhubung ke __CAPGO_KEEP_0__ (

Lovable project connected to GitHub (__CAPGO_KEEP_0__ +)
Capacitor @capgo/capacitor-updater di repo (Lovable ke mobile guide)
Aplikasi terdaftar di Capgo dengan capacitor.config.ts menunjuk ke saluran yang benar appId
production saluran ada dan terhubung ke build yang digunakan pengguna Anda

Mengapa `--auto-bump`

Setiap unggahan Capgo memerlukan versi bundle yang unik Lovable Publish tidak akan meningkatkanuntuk Anda, sehingga CI akan gagal pada deploy kedua jika Anda menggunakan versi yang sama. package.json membaca versi terbaru di saluran (atau aplikasi) dan meningkatkannya. Level default adalah

--auto-bump Anda dapat melewati minorLovable Publish tidak akan meningkatkan versi untuk Anda, sehingga CI akan gagal pada deploy kedua jika Anda menggunakan versi yang sama. --auto-bump patch atau --auto-bump major jika Anda lebih suka.

Langkah 1 — Buatlah kunci Capgo API

Buka 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 ini seperti kata sandi. Jangan pernah komitnya ke Git atau tempelkan ke Lovable chat.

Langkah 2 — Tambahkan `CAPGO_TOKEN` dalam GitHub (langkah env yang hanya satu)

Ini adalah langkah yang Anda kirimkan kepada Kuldeep dan klien mana pun yang memiliki repositori.

Buka repositori GitHub yang Lovable sinkronkan
Pergi ke Pengaturan → Rahasia dan variabel → Aksi
Klik 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 }}. Aliran kerja di bawah ini membacanya sebagai variabel lingkungan untuk __CAPGO_KEEP_0__ __CAPGO_KEEP_1__. CAPGO_TOKEN environment variable for the Capgo CLI.

If repo Anda berada di bawah organisasi klien, mereka harus menambahkan rahasia di di repo Anda. Anda hanya memerlukan kunci di GitHub, bukan di pengaturan Lovable.

Langkah 3 — Salin prompt ini ke Lovable

Salin blok di bawah ke obrolan Lovable. Jika cabang default Anda bukanlah main, ganti main 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 Publish agar 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 teks promosi). Sesuaikan langkah instalasi/bangun seperti aturan di atas jika proyek Anda berbeda, lalu commit 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 yang disukai sering memerlukan base: './' di vite.config.ts agar aset muat di dalam shell native. Jika pengguna melihat layar putih setelah pembaruan OTA, minta Lovable untuk mengatur base: './', publikasikan lagi, dan biarkan alur kerja meredeploy.

Bundel terenkripsi: Jika Anda menggunakan Capgo enkripsi, tambahkan CAPGO_PRIVATE_KEY sebagai rahasia GitHub kedua dan kirim --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" di langkah unggah.

Langkah 4 — Konfirmasi Publikasi mengaktifkan pengiriman

Di Lovable, buat perubahan kecil yang dapat dilihat (misalnya teks label tombol)
Klik Publish
Pada GitHub, buka Aksi dan lihat Capgo Live Updates
context: Halaman/area: Halaman produk live update. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman live-update.astro. Simpan istilah produk/merek Capgo dan istilah developer secara tepat. Kunci pesan `live_update_hero_badge` (Lambang Live Update Hero). Capgo console __CAPGO_KEEP_0__ console dan konfirmasi bundle baru di production saluran
Pada perangkat dengan aplikasi yang terpasang, konfirmasikan perubahan tersebut (mungkin membutuhkan satu menit tergantung pada pengaturan saluran)

✅ Sukses: Publikasikan di Lovable → hijau GitHub Action → bundle baru di Capgo → pengguna mendapatkan pembaruan.

Pengaturan

context: Halaman/area: Bantuan / halaman bantuan premium atau bagian bantuan di footer. Peran: Judul bagian atau halaman. Dilihat di: halaman support-policy.astro. Kunci pesan `support_policy_troubleshooting_title` (Judul Pengaturan Bantuan)	Gejala	Penyebab mungkin
Pengembalian	Aliran kerja tidak pernah berjalan `main`	Push pergi ke cabang lain dari `branches` Perubahan dalam aliran kerja atau publikasikan ke `main`
`CAPGO_TOKEN` / error autentikasi	Kunci rahasia hilang atau nama salah	Kunci rahasia harus tepatnya `CAPGO_TOKEN` di bawah rahasia Actions
Versi sudah ada	Upload menggunakan versi bundle yang sama	Tetapkan `--auto-bump` di langkah unggah (atau lewati `--auto-bump patch`)
Gagal membangun di `npm ci`	Lockfile tidak sinkron	Jalankan `npm install` secara lokal, komit `package-lock.json`Menerbitkan lagi
Upload berhasil, layar putih	Salah `webDir` atau Vite `base`	Match `capacitor.config.ts` `webDir` untuk hasil pembangunan (`dist` untuk Vite) dan tetapkan `base: './'`
Pengguna tidak melihat perbaruan	Saluran tidak terkait dengan pembangunan mereka	Pada Capgo, hubungkan pembangunan perangkat ke `production` atau tetapkan saluran menjadi publik

Untuk pola kerja aliran lainnya (cabang fitur, saluran PR, enkripsi), lihat Integrasi GitHub 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 mengklik Publish di Lovable kapan saja mereka ingin pengguna menerima perubahan.
Mereka tidak pernah menjalankan npx @capgo/cli lokal kecuali mereka ingin.

Itu sesuai dengan pengalaman satu-klik yang mereka minta: Publikasi di Lovable adalah tombol; GitHub Aksi dan Capgo akan menangani sisanya.

Lanjutkan

Mengubah Lovable ke iOS dan Android — Konfigurasi lengkap Capacitor + Capgo jika Anda belum menggulung aplikasi
Pembangunan otomatis dan rilis dengan GitHub Aksi — Rilis berdasarkan tag dan peningkatan versi
Integrasi GitHub Aksi konteks
Capgo Live Updates --- Saluran, pengembalian, dan statistik adopsi

Mengaktifkan Capgo Live Update dari Lovable dengan GitHub Actions