Klien Anda ingin satu tombol di Lovable yang mengirim perubahan ke semua pengguna aktif. Anda sudah membuktikan alur update berjalan secara manual:
npx @capgo/cli@latest bundle upload --channel=production --auto-bump
Bagian yang hilang bukan perintah terminal lain di dalam Lovable. Lovable tidak dapat menjalankan Capgo saat Publish. Ketika sinkronisasi GitHub diaktifkan, Publish mendorong commit ke repo Anda. GitHub Actions menjalankan build dan bundle upload untuk Anda.
Panduan ini mencakup satu-satunya setup manual yang harus dilakukan klien sekali: tambahkan CAPGO_TOKEN sebagai secret GitHub. Untuk file workflow, salin-tempel instruksi AI yang siap pakai ke Lovable (Langkah 3).
Cara kerja pipeline
| Langkah | Siapa | Apa yang terjadi |
|---|---|---|
| 1 | Klien | Mengedit aplikasi di Lovable dan mengklik Publikasikan |
| 2 | Lovable | Commit dan push ke GitHub (biasanya main) |
| 3 | Aksi GitHub | npm ci, npm run build, bundle upload --auto-bump ke Capgo |
| 4 | Capgo | Perangkat aktif pada production channel menerima update |
Tanpa SSH, tanpa CLI lokal, tanpa klik tambahan setelah secret dikonfigurasi.
Prerequisites
- Proyek Lovable terhubung ke GitHub (panduan export)
- Capacitor +
@capgo/capacitor-updaterin the repo (panduan Lovable ke mobile) - App terdaftar di Capgo dengan
capacitor.config.tsyang mengarah ke yang benarappId productionchannel tersedia dan terhubung ke build yang dijalankan user Anda
Mengapa --auto-bump
Setiap upload Capgo memerlukan versi bundle unik yang baru. Lovable Publish tidak menaikkan package.json untuk Anda, jadi CI akan gagal pada deploy kedua jika Anda memakai ulang versi yang sama.
--auto-bump membaca versi terbaru pada channel (atau app) dan menaikkannya. Level default adalah minor. Anda bisa meneruskan --auto-bump patch atau --auto-bump major jika Anda mau.
Langkah 1 — Buat kunci Capgo API
- Buka console.capgo.app/apikeys/
- Buat key API dengan izin untuk upload bundle aplikasi Anda
- Salin key ini sekali saja. Anda tidak akan bisa melihat nilai lengkapnya lagi
Perlakukan key ini seperti password. Jangan pernah commit ke Git atau tempel ke chat Lovable.
Langkah 2 — Tambahkan CAPGO_TOKEN di GitHub (satu-satunya langkah env)
Ini langkah yang Anda kirim ke Kuldeep dan klien mana pun yang memiliki repo tersebut.
- Buka repo GitHub yang disinkronkan Lovable
- Buka Pengaturan → Secrets dan variables → Aksi
- Klik Secret repositori baru
- Nama:
CAPGO_TOKEN - Value: tempelkan kunci Capgo API dari Langkah 1
- Simpan
GitHub menyuntikkan secret ke dalam workflow sebagai ${{ secrets.CAPGO_TOKEN }}. Workflow di bawah membacanya sebagai CAPGO_TOKEN variabel lingkungan untuk Capgo CLI.
Jika repo ada di organisasi klien Anda, mereka harus menambahkan secret di repo mereka. Anda hanya perlu key di GitHub, bukan di pengaturan Lovable.
Langkah 3 — Tempel prompt ini ke Lovable
Salin blok di bawah ini ke chat Lovable. Jika default branch Anda bukan main, ganti main di dalam workflow dengan nama branch 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 agar workflow mengarah ke GitHub.
Alternatif manual
Jika Anda tidak ingin menggunakan chat Lovable, buatlah .github/workflows/capgo-live-updates.yml dengan YAML ini saja (bukan teks prompt). Sesuaikan langkah install/build dengan 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 Lovable Vite sering membutuhkan base: './' di vite.config.ts agar aset dimuat di dalam shell native. Jika pengguna melihat layar putih setelah update OTA, minta Lovable untuk mengatur base: './', publish ulang, dan biarkan workflow melakukan redeploy.
Bundle terenkripsi: If you use enkripsi Capgo, tambahkan CAPGO_PRIVATE_KEY sebagai GitHub rahasia kedua dan pass --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" pada langkah upload.
Langkah 4 — Konfirmasi Publish memicu deploy
- Di Lovable, buat perubahan kecil yang terlihat (misalnya teks label tombol)
- Klik Publikasikan
- Di GitHub, buka Aksi dan pantau Live Updates Capgo
- Saat job sudah berwarna hijau, buka konsol Capgo dan konfirmasi bundle baru di
productionchannel - Di perangkat yang sudah terpasang aplikasinya, pastikan perubahan masuk (bisa butuh satu menit tergantung pengaturan channel).
✅ Berhasil: Publish di Lovable → Action GitHub hijau → bundle baru di Capgo → pengguna dapat update.
Pemecahan Masalah
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| Workflow tidak pernah berjalan | Push dilakukan ke branch selain main |
Perubahan branches di workflow atau publish ke main |
CAPGO_TOKEN / error autentikasi |
Secret hilang atau namanya salah | Secret harus persis CAPGO_TOKEN di bawah Actions secrets |
| Version already exists | Upload menggunakan versi bundle yang sama | Pertahankan --auto-bump pada langkah upload (atau berikan --auto-bump patch) |
Build gagal pada npm ci |
Lockfile tidak sinkron | Jalankan npm install secara lokal, commit package-lock.json, publikasikan lagi |
| Upload berhasil, layar putih | Salah webDir atau Vite base |
Cocokkan capacitor.config.ts webDir dengan output build (dist untuk Vite) dan atur base: './' |
| User tidak melihat update | Channel tidak terhubung ke build mereka | Di Capgo, hubungkan device build ke production atau atur channel ke publik |
Untuk pola workflow lainnya (feature branches, PR channels, enkripsi), lihat Integrasi GitHub Actions.
Apa yang Anda katakan ke klien
Kirim checklist ini ke mereka:
- Anda sudah menghubungkan Lovable ke GitHub dan menyiapkan Capgo di aplikasi mobile.
- Mereka menambahkan satu secret GitHub:
CAPGO_TOKENdengan kunci Capgo API mereka (halaman apikeys). - Mereka klik Publikasikan di Lovable kapan pun mereka ingin pengguna menerima perubahan.
- Mereka tidak pernah menjalankan
npx @capgo/clisecara lokal kecuali mereka mau.
Itu cocok dengan pengalaman sekali klik yang mereka minta: Publish di Lovable adalah tombolnya; GitHub Actions dan Capgo menangani sisanya.
Lanjut terus
- Konversi Lovable ke iOS dan Android — Setup Capacitor + Capgo lengkap jika Anda belum membungkus aplikasi
- Build dan rilis otomatis dengan GitHub Actions — Rilis berbasis tag dan peningkatan versi
- Integrasi GitHub Actions — Multi-channel dan channel pratinjau PR
- Live Updates Capgo — Channel, rollback, dan statistik adopsi