Automasi Capgo Live Updates dari Lovable dengan GitHub Actions

Klien Anda ingin sebuah tombol tunggal di Lovable yang mengirimkan perubahan ke setiap pengguna aktif. Anda sudah membuktikan jalur update berhasil secara manual:

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 saat Publish. Ketika GitHub sinkronisasi diaktifkan, Publish mengirimkan komit ke repositori Anda. GitHub Actions menjalankan build dan bundle upload mengirimkannya untuk Anda.

Guid ini menjelaskan setup manual yang klien Anda harus lakukan sekali saja: tambahkan CAPGO_TOKEN sebagai rahasia GitHub. Untuk file workflow, 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 Publish
2	Lovable	Menyimpan dan memasukkan 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 ada SSH, tidak ada __CAPGO_KEEP_0__ lokal, tidak ada klik tambahan setelah rahasia dikonfigurasi.

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

Persyaratan

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 Persyaratan . Lovable Publish tidak akan meningkatkan versi 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 untuk Anda 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

Tatalah kunci ini seperti kata sandi. Jangan pernah komitnya ke Git atau tempelkan ke obrolan Lovable.

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

Langkah ini yang Anda kirimkan kepada Kuldeep dan klien mana pun yang memiliki repositori.

Buka repositori GitHub yang Lovable sinkronkan ke
Pergi ke Pengaturan → Rahasia dan variabel → Aksi
Klik Buat rahasia repositori baru
Nama: CAPGO_TOKEN
Nilai: salin kunci Capgo API dari Langkah 1
Simpan

GitHub menyuntikkan rahasia ke dalam aliran kerja sebagai ${{ secrets.CAPGO_TOKEN }}. Aliran kerja di bawah membacanya sebagai variabel lingkungan untuk __CAPGO_KEEP_0__ __CAPGO_KEEP_1__. CAPGO_TOKEN environment variable for the Capgo CLI.

mereka Anda hanya memerlukan kunci di __CAPGO_KEEP_0__, bukan di pengaturan Lovable. repo. You only need the key in GitHub, not in Lovable settings.

Salin blok di bawah ke obrolan Lovable. Jika cabang default Anda bukanlah

, ganti maindi aliran kerja dengan nama cabang Anda. main Setelah Lovable menerapkan perubahan, klik

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.

Simpan Publish Jadi aliran kerja mendarat di GitHub.

Alternatif manual

Jika Anda lebih suka tidak menggunakan percakapan Lovable, buat .github/workflows/capgo-live-updates.yml Dengan YAML ini saja (bukan prosa prompt). Adapt langkah instalasi/bangun seperti 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: './' di vite.config.ts sehingga aset muat di dalam shell native. Jika pengguna melihat layar putih setelah pembaruan OTA, minta Lovable untuk mengatur base: './', publik lagi, dan biarkan aliran kerja meredeploy.

Bundle yang dienkripsi: Jika Anda menggunakan Capgo enkripsi, tambahkan CAPGO_PRIVATE_KEY GitHub rahasia sebagai rahasia kedua dan kirimkan --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" pada langkah unggah.

Langkah 4 — Konfirmasi Publikasi mengaktifkan deploy

Di Lovable, buat perubahan kecil yang dapat dilihat (misalnya teks label tombol)
Klik Publikasi
Di GitHub, buka Aksi dan lihat Capgo Aktualisasi Langsung
Ketika pekerjaan hijau, buka konsol __CAPGO_KEEP_0__ Anda Capgo console Konfirmasi perubahan di __CAPGO_KEEP_1__ production Sukses:
Publikasikan di Lovable → hijau __CAPGO_KEEP_0__ Action → paket baru di __CAPGO_KEEP_1__ → pengguna mendapatkan update.

✅ Pengaturan Tambahan Publish in Lovable → green GitHub Action → new bundle in Capgo → users get the update.

Pemicu yang Mungkin

Pemecahan Masalah	__CAPGO_KEEP_0__ Aktualisasi Langsung	Ketika pekerjaan hijau, buka konsol __CAPGO_KEEP_0__ Anda dan konfirmasi paket baru di __CAPGO_KEEP_1__
Alur kerja tidak pernah dijalankan	Push pergi ke cabang lain dari `main`	Perubahan `branches` di alur kerja atau publikasikan ke `main`
`CAPGO_TOKEN` / error autentikasi	Rahasia hilang atau nama salah	Rahasia harus tepatnya `CAPGO_TOKEN` di bawah rahasia Actions
Versi sudah ada	Upload mengulangi versi bundle yang sama	Tetapkan `--auto-bump` di langkah unggah (atau lewati `--auto-bump patch`)
Gagal build pada `npm ci`	Lockfile tidak sinkron	Jalankan `npm install` secara lokal, commit `package-lock.json`, publik ulang
Upload berhasil, layar putih	Salah `webDir` atau Vite `base`	Sesuai `capacitor.config.ts` `webDir` dengan hasil build (`dist` untuk Vite) dan atur `base: './'`
Pengguna tidak melihat perbaruan	Saluran tidak terkait dengan pembangunan mereka	Ini Capgo, hubungkan pembangunan perangkat ke `production` atau atur saluran ke publik

Untuk pola aliran kerja yang lebih banyak (cabang fitur, saluran PR, enkripsi), lihat GitHub Integrasi Aksi.

context: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Kalimat copy situs web. Dilihat di: halaman solusi/qsr.astro. Simpan Capgo produk/merek dan istilah pengembang secara tepat. Kunci pesan `solutions_qsr_sol4_point1` (Solutions Qsr Sol4 Point1)

Apa yang Anda katakan kepada klien

Kirimkan daftar periksa ini: already connected Lovable to GitHub and set up Capgo on the mobile app.
context: Fragment teks HTML dari kalimat Capgo UI yang lebih panjang (kunci induk `you_definition`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat pemasaran atau hukum yang panjang. Dilihat di: halaman pengakuan.astro, halaman kembali.astro. Kunci pesan `you_definition` (You Definition) sudah terhubung Lovable ke GitHub dan mengatur __CAPGO_KEEP_1__ di aplikasi seluler. CAPGO_TOKEN with their Capgo API key (halaman API keys).
Mereka Klik Publish di Lovable setiap kali mereka ingin pengguna menerima perubahan.
Mereka tidak pernah menjalankan npx @capgo/cli lokal kecuali mereka ingin.

Hal itu sesuai dengan pengalaman tunggal klik yang mereka minta: Publish di Lovable adalah tombol; GitHub Aksi dan Capgo akan menangani sisanya.

Teruskan

Mengonversi Lovable ke iOS dan Android — Setup lengkap Capacitor + Capgo jika Anda belum menggulung aplikasi
Pembangunan otomatis dan rilis dengan GitHub Aksi — Rilis berdasarkan tag dan peningkatan versi
GitHub Integrasi Aksi Page/area: Solusi Capgo. Role: Kalimat copy situs web. Dilihat di: halaman solusi/qsr.astro. Simpan produk/merk dan istilah pengembang Capgo secara tepat.
Capgo Live Updates __CAPGO_KEEP_0__ Perbarui Hidup

Automasi Capgo Update Hidup dari Lovable dengan GitHub Aksi