Automate Capgo Live Updates dari Lovable dengan GitHub Aksi

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

Bagian yang hilang bukanlah perintah terminal lain di dalam Lovable. Lovable tidak dapat menjalankan Capgo pada Terbitkan. Ketika GitHub sinkronisasi diaktifkan, Publish push sebuah perubahan ke repositori Anda. GitHub Aksi menjalankan build dan bundle upload untuk Anda.

Panduan ini menjelaskan satu-satunya pengaturan manual yang harus dilakukan oleh klien Anda sekali: menambahkan CAPGO_TOKEN sebagai rahasia GitHub . Semua yang lain dapat ditambahkan dengan menggunakan prompt yang disukai atau file workflow kecil.

Bagaimana pipa kerja

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

Proyek Lovable terhubung ke __CAPGO_KEEP_0__ (

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

Langkah 1 — Buat kunci Capgo API

1. Buka console.capgo.app/apikeys/
2. Buat kunci API dengan izin untuk mengunggah bundle untuk aplikasi Anda
3. Salin kunci sekali. Anda tidak akan melihat nilai lengkapnya lagi

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

Langkah 2 — Tambah CAPGO_TOKEN dalam GitHub (langkah satu-satunya env)

Langkah ini yang dikirimkan ke Kuldeep dan klien mana pun yang memiliki repositori.

1. Buka repositori GitHub yang Lovable sinkronkan ke
2. Pergi ke Pengaturan → Rahasia dan variabel → Aksi
3. Klik Repository rahasia baru
4. Nama: CAPGO_TOKEN
5. Nilai: tempel kunci Capgo API dari Langkah 1
6. Simpan

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

repo mereka. Anda hanya memerlukan kunci di __CAPGO_KEEP_0__, bukan di pengaturan Lovable. Langkah 3 — Tambahkan __CAPGO_KEEP_0__ alur kerja Actions repo. You only need the key in GitHub, not in Lovable settings.

Step 3 — Add the GitHub Actions workflow

Pilihan B — Tambahkan file sendiri

Buat main):

Create `.github/workflows/capgo-live-updates.yml` that runs on every push to `main`:

1. Checkout code
2. Setup Node.js 24 with npm cache
3. Run `npm ci` and `npm run build`
4. Run `npx @capgo/cli@latest bundle upload --channel=production`
5. Use environment variable `CAPGO_TOKEN` from GitHub Actions secrets (do not hardcode the API key)

Use `actions/checkout@v6` and `actions/setup-node@v6`. Commit the workflow file to the repo.

Step 4 — Tambahkan __CAPGO_KEEP_0__ Actions workflow

Option A — Mintalah Lovable untuk membuat file

Salin ini ke obrolan Lovable (sesuaikan nama cabang jika default Anda bukan .github/workflows/capgo-live-updates.yml:

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
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Commit dan push. Langkah pertama dimulai segera setelah GitHub menerima push.

Vite base path: Aplikasi Vite yang disukai sering memerlukan base: './' di vite.config.ts jadi aset muat di dalam shell native. Jika pengguna melihat layar putih setelah update OTA, perbaiki 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 }}" pada langkah unggah.

Langkah 4 — Konfirmasi Publikasikan mengaktifkan deploy

1. Di Lovable, buat perubahan kecil yang dapat dilihat (misalnya teks label tombol)
2. Klik Publikasikan
3. Pada GitHub, buka Aksi dan tonton Capgo Live Updates
4. Ketika pekerjaan berwarna hijau, buka konsol Capgo dan konfirmasi bundle baru pada production saluran
5. Pada perangkat dengan aplikasi terinstal, konfirmasikan perubahan tersebut (mungkin membutuhkan satu menit tergantung pada pengaturan saluran)

✅ Sukses: Publish di Lovable → hijau GitHub Aksi → bundle baru di Capgo → pengguna mendapatkan update.

Pengaturan

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

Apa yang Anda katakan kepada klien

Kirimkan daftar periksa ini kepada mereka:

1. Anda sudah terhubung Lovable ke GitHub dan mengatur Capgo di aplikasi seluler.
2. Mereka tambahkan satu GitHub rahasia: CAPGO_TOKEN dengan Capgo API kunci (halaman apikeys).
3. Mereka klik Publikasikan di Lovable ketika mereka ingin pengguna menerima perubahan.
4. Mereka tidak pernah menjalankan npx @capgo/cli lokal kecuali mereka ingin.

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

Teruslah berlanjut

• Mengonversi Lovable ke iOS dan Android --- Penuhkan Capacitor + Capgo jika Anda belum menggandakan aplikasi
• Pembangunan otomatis dan rilis dengan GitHub Actions --- Rilis berdasarkan tag dan peningkatan versi
• Integrasi GitHub Actions --- Saluran multi dan pratinjau saluran PR
• Capgo Live Updates --- Saluran, pengembalian ke versi sebelumnya, dan statistik adopsi