자동화 Capgo Live Updates from Lovable with GitHub Actions

클라이언트가 모든 활성 사용자에게 변경 사항을 전송하는 단일 버튼이 있는 Lovable이 필요합니다. 이미 업데이트 경로가 작동하는지 증명했습니다:

npx @capgo/cli@latest bundle upload --channel=production --auto-bump

다른 터미널 명령어를 Lovable 내부에 추가하는 것이 아님 Lovable은 Capgo을 Capgo Publish에 실행할 수 없습니다. GitHub Sync가 활성화되면 __CAPGO_KEEP_0__ Publish는 리포지토리에 커밋을 푸시합니다.. GitHub Actions는 빌드와 bundle upload for you.

이 안내서에서는 클라이언트가 한 번만 수행해야 하는 수동 설정에 대해 다룹니다: 추가 CAPGO_TOKEN GitHub

pipeline 작동 방식

단계	누구	무엇이 발생하는가
1	클라이언트	__CAPGO_KEEP_0__에서 앱을 편집하고 Publish 버튼을 클릭합니다. Publish
2	Lovable	GitHub `main`)
3	GitHub	`npm ci`, `npm run build`, `bundle upload --auto-bump` to Capgo
4	Capgo	활성화된 기기 `production` 채널에 있는 기기

SSH, 로컬 CLI, 추가 클릭 없이 비밀번호가 설정된 후

필수 조건

GitHub과 연결된 lovable 프로젝트__CAPGO_KEEP_0__ export 가이드)
Capacitor + @capgo/capacitor-updater __CAPGO_KEEP_0__ 내에로우블 프로젝트에서 모바일 가이드)
Capgo에 앱이 등록되어 capacitor.config.ts 정확한 채널을指向하는 appId
production 채널이 존재하고 사용자들이 실행하는 빌드와 연결되어

Why `--auto-bump`

모든 Capgo 업로드는 새로운 유니크한 버전의배포본이 필요합니다. package.json Lovable Publish는 버전을

--auto-bump 업데이트하지 않기 때문에 CI는 동일한 버전을 재사용할 경우 두 번째 배포에서 실패합니다. minor최신 버전을 읽고 버전을 증가시킵니다. 기본 수준은 --auto-bump patch 입니다. --auto-bump major 또는

Step 1 — Capgo Capgo API 설정

만약 Step 1 — capgo __CAPGO_KEEP_1__ 키를 생성하세요. (Capacitor Live Update Alternatives Comparison Page에서 사용되는 UI Label. Page/area: About Capgo Page. Role: UI Label. Seen in: page about.astro. Message key `about_how_step_label` (About How Step Label). )
Capgo Live Update를 API 키에 대한 권한이 있는 앱에 업로드할 패키지를 업로드할 수 있는 키를 생성하세요.
__CAPGO_KEEP_0__ 키를 복사하세요. 다시는 전체 값을 볼 수 없습니다.

__CAPGO_KEEP_0__ 키를 암호처럼 다루세요. Git에 커밋하지 마세요. Lovable 채팅에 붙여넣지 마세요.

Step 2 — 추가 `CAPGO_TOKEN` GitHub (단일 환경 단계)에서

이 단계는 Kuldeep과 저장소 소유자에게 보냅니다.

GitHub 저장소 (Lovable이 동기화하는 저장소)를 열어보세요.
설정 비밀 및 변수 → 액션 → 클릭
Click 새로운 저장소 비밀
이름: CAPGO_TOKEN
Capgo API 키를 Step 1에서 복사하여 붙여 넣으십시오.
저장

GitHub는 워크플로우에 비밀을 주입합니다. ${{ secrets.CAPGO_TOKEN }}아래 워크플로우는 CAPGO_TOKEN 환경 변수로 Capgo의 Capgo CLI을 사용합니다.

저장소 their repo. GitHub 에는 키만 필요합니다. Lovable 설정에는 넣지 않습니다.

Lovable

Step 3 — Lovable에 이 문구를 붙여 넣으십시오. main자동화 main 워크플로우에 branch 이름을 넣어주세요.

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.

변경이 적용된 후 Lovable에서 Publish 버튼을 클릭하세요. 게시 이러한 workflow가 GitHub에 도착하도록 하세요.

수동 대안

만약 당신이 Lovable 채팅을 사용하지 않으려면 .github/workflows/capgo-live-updates.yml Vite

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 }}

경로: base path: 내 base: './' path: vite.config.ts 자원들이 네이티브 셸 내부에서 로드됩니다. 사용자가 OTA 업데이트 후 흰 화면을 보는 경우, Lovable에게 다시 배포하도록 요청하세요. base: './'다시 배포하도록 요청하세요.

암호화된 패키지: Capgo를 사용한다면 Capgo 암호화4단계 — 배포 확인: CAPGO_PRIVATE_KEY GitHub를 두 번째 비밀 키로 지정하고 전달하십시오. --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" Lovable에서 작은 변경 사항을 만들어서 표시하세요 (예를 들어 버튼 레이블 텍스트)

배포

배포
배포 배포
On GitHub, GitHub 열기 Actions and watch Capgo 실시간 업데이트
페이지/영역: Live updates 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: 페이지 live-update.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지하세요. 메시지 키 `live_update_hero_badge` (Live Update Hero Badge). 작업이 초록색이면 Capgo 콘솔을 열고 __CAPGO_KEEP_0__ 콘솔 production channel
채널

✅ Success: Publish in Lovable → green GitHub Action → 새로운 Capgo 패키지 → 사용자들은 업데이트를 받습니다.

Troubleshooting

증상	가능한 원인	수정
워크플로우가 실행되지 않음	다른 branch로 푸시 `main`	변경 `branches` 워크플로우 또는 `main`
`CAPGO_TOKEN` / auth 오류	비밀번호가 없거나 이름이 잘못됨	비밀번호가 정확히 `CAPGO_TOKEN` Actions 비밀번호
버전이 이미 존재함	업로드 된 버전이 동일한 번들 버전을 재사용했습니다.	유지 `--auto-bump` 업로드 단계에서 (또는 패스) `--auto-bump patch`)
빌드가 실패합니다. `npm ci`	Lockfile이 동기화되지 않습니다.	실행 `npm install` 로컬에서 업데이트를 자동화하는 방법 `package-lock.json`로컬에서 업데이트를 자동화하는 방법
로컬에서 업데이트를 자동화하는 방법	Wrong `webDir` Live Update `base`	Match `capacitor.config.ts` `webDir` 빌드 출력 (`dist` Vite) 에서 생성하고 설정 `base: './'`
사용자는 업데이트를 볼 수 없습니다	채널이 사용자의 빌드와 연결되지 않았습니다	Capgo 에서 장치 빌드를 Capgo 에 연결하거나 `production` 채널을 공개로 설정

더 많은 워크플로우 패턴 (기능 branch, PR 채널, 암호화) 을 보려면 GitHub Actions 통합.

고객에게 말하는 것

이 체크리스트를 보내세요

당신 이미 Lovable을 GitHub 에 연결하고 모바일 앱에서 Capgo 을 설정했습니다
그들은 GitHub 비밀을 하나 추가합니다: CAPGO_TOKEN Capgo API 키 (apikeys 페이지).
그들은 클릭 게시 로블로블(Lovable)에서 사용자가 변경 사항을 받기를 원할 때마다.
그들은 npx @capgo/cli 로컬에서

자동화된 Live Update는 사용자가 원하는 단일 클릭 경험을 제공합니다: Lovable에서 게시하는 버튼; GitHub Actions와 Capgo은 나머지 작업을 처리합니다.

Keep going

iOS와 Android로 변환 — 아직 앱을 wrapping하지 않았다면 Capacitor + Capgo 설정을 완전히 수행하세요
GitHub Actions를 사용하여 자동 빌드 및 릴리즈 — 태그 기반 릴리즈 및 버전 업
GitHub Actions 통합 — 다중 채널 및 PR 미리보기 채널
Capgo 실시간 업데이트 — 채널, 롤백, 및 수용 통계

Capgo Live Updates를 GitHub Actions으로 자동화하는 방법