Langsung ke konten utama
CI/CD

Otomatiskan Capgo Live Updates dari Lovable dengan GitHub Actions

Publish Lovable ke pengguna produksi dengan satu klik: sinkronkan ke GitHub, simpan key Capgo API sebagai secret, dan biarkan GitHub Actions build dan upload pada setiap push.

Ilustrasi blog: Otomatiskan Capgo Live Updates dari Lovable dengan GitHub Actions Capgo

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-updater in the repo (panduan Lovable ke mobile)
  • App terdaftar di Capgo dengan capacitor.config.ts yang mengarah ke yang benar appId
  • production channel 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

  1. Buka console.capgo.app/apikeys/
  2. Buat key API dengan izin untuk upload bundle aplikasi Anda
  3. 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.

  1. Buka repo GitHub yang disinkronkan Lovable
  2. Buka Pengaturan → Secrets dan variables → Aksi
  3. Klik Secret repositori baru
  4. Nama: CAPGO_TOKEN
  5. Value: tempelkan kunci Capgo API dari Langkah 1
  6. 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

  1. Di Lovable, buat perubahan kecil yang terlihat (misalnya teks label tombol)
  2. Klik Publikasikan
  3. Di GitHub, buka Aksi dan pantau Live Updates Capgo
  4. Saat job sudah berwarna hijau, buka konsol Capgo dan konfirmasi bundle baru di production channel
  5. 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:

  1. Anda sudah menghubungkan Lovable ke GitHub dan menyiapkan Capgo di aplikasi mobile.
  2. Mereka menambahkan satu secret GitHub: CAPGO_TOKEN dengan kunci Capgo API mereka (halaman apikeys).
  3. Mereka klik Publikasikan di Lovable kapan pun mereka ingin pengguna menerima perubahan.
  4. Mereka tidak pernah menjalankan npx @capgo/cli secara 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

Live updates untuk aplikasi Capacitor

Saat bug web-layer sudah live, kirim perbaikannya lewat Capgo alih-alih menunggu berhari-hari untuk persetujuan app store. Pengguna mendapat update di background, sementara perubahan native tetap mengikuti jalur review normal.

Terbaru dari Blog kami

Capgo memberikan insight terbaik yang Anda butuhkan untuk membuat aplikasi mobile yang benar-benar profesional.