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 Publikasi. Ketika sinkronisasi GitHub diaktifkan, Publish mengirimkan perubahan kode ke repositori Anda. GitHub Aksi menjalankan build dan bundle upload untuk Anda.

Petunjuk ini menjelaskan langkah-langkah manual yang harus dilakukan oleh klien sekali saja: menambahkan CAPGO_TOKEN sebagai rahasia GitHub . Semua yang lain dapat ditambahkan dengan menggunakan prompt Lovable atau file workflow kecil.

Bagaimana cara kerja pipeline

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 repo (Petualang ke guide mobile)
• Aplikasi terdaftar di Capgo dengan capacitor.config.ts mengarah ke kanal yang benar appId
• production salah satu syarat channel ada dan terhubung ke build yang digunakan pengguna Anda

Langkah 1 — Buat Capgo API kunci

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 chat Lovable.

Langkah 2 — Tambah CAPGO_TOKEN di GitHub (langkah satu-satunya untuk mengatur lingkungan)

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

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

GitHub memasukkan rahasia ke dalam alur kerja sebagai ${{ secrets.CAPGO_TOKEN }}. Alur kerja di bawah ini membacanya sebagai CAPGO_TOKEN variabel lingkungan untuk Capgo CLI.

Jika repo Anda berada di bawah organisasi klien, mereka harus menambahkan rahasia di repo mereka. Anda hanya memerlukan kunci di __CAPGO_KEEP_0__, bukan di pengaturan Lovable. Langkah 3 — Tambahkan GitHub Actions workflow

Step 3 — Add the GitHub Actions workflow

Salin ini ke obrolan Lovable (sesuaikan nama cabang jika default Anda bukanlah

Lovable akan menambahkan YAML dan mengirimkannya ke repositori pada publikasi berikutnya. 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.

Pilihan B — Tambahkan file sendiri

Buat file

Create .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 lewatkan --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. Saat pekerjaan berwarna hijau, buka konsol Capgo dan konfirmasi bundle baru pada production channel
5. Pada perangkat dengan aplikasi terinstal, konfirmasikan perubahan tersebut (mungkin membutuhkan satu menit tergantung pada pengaturan channel)

✅ Success: Publikasikan di Lovable → hijau GitHub Aksi → bundle baru di Capgo → pengguna mendapatkan update.

Troubleshooting

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 mobile.
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 akan mengurus sisanya.

Teruslah berlanjut

• Konversi Lovable ke iOS dan Android — Konfigurasi lengkap Capacitor + Capgo jika Anda belum mengelilingi aplikasi
• Pembangunan otomatis dan rilis dengan GitHub Actions — Rilis berdasarkan tag dan peningkatan versi
• Integrasi GitHub Actions — Saluran multi dan saluran pratinjau PR
• Capgo Live Updates — Saluran, rollback, dan statistik adopsi