Lovable의 Capgo 실시간 업데이트를 GitHub 액션으로 자동화하세요

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

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

미ISSING 조각은 Lovable 내부에 또 다른 터미널 명령어가 아닙니다. Lovable은 Publish 시 Capgo를 실행할 수 없습니다. GitHub 동기화가 활성화되면, __CAPGO_KEEP_0__GitHub bundle upload 이 작업은 __CAPGO_KEEP_0__에 저장된 비밀을 사용하여 자동화됩니다.

이 안내서에서는 클라이언트가 한 번만 수행해야 하는 유일한 수동 설정에 대해 설명합니다: __CAPGO_KEEP_0__를 추가합니다. CAPGO_TOKEN as a GitHub secret. Everything else can be added with a Lovable prompt or a small workflow file.

pipeline이 어떻게 작동하는지

단계	누구	무엇이 발생하는지
1	클라이언트	Lovable에서 앱을 편집하고 Publish를 클릭합니다.
2	__CAPGO_KEEP_0__	GitHub (일반적으로 `main`)
3	GitHub 액션	`npm ci`, `npm run build`, `bundle upload` Capgo
4	Capgo	__CAPGO_KEEP_0__ 채널에 연결된 활성 기기 `production` __CAPGO_KEEP_0__ 업데이트를 받습니다.

SSH가 없고 CLI가 없고 비밀번호를 설정한 후 추가 클릭이 필요하지 않습니다.

사전 요구 사항

GitHub와 연결된 lovable 프로젝트 (__CAPGO_KEEP_0__ export 가이드)
Capacitor + @capgo/capacitor-updater 저장소 (모바일 가이드)
Capgo에 앱을 등록했습니다. capacitor.config.ts 정확한 appId
production 채널이 존재하고 사용자들이 실행하는 빌드와 연결되어 있습니다.

Step 1 — Capgo API 키를 생성하세요.

Open capgo.console.app/apikeys/
API 키를 생성하세요. 이 키는 앱을 업로드할 수 있는 권한이 있습니다.
키를 한 번 복사하세요. 다시는 전체 값을 볼 수 없습니다.

이 키를 비밀번호처럼 다뤄세요. Git에 커밋하거나 Lovable 채팅에 붙여넣지 마세요.

Step 2 — 추가 `CAPGO_TOKEN` GitHub (환경 설정 단계에서만 사용합니다.)

이 단계는 Kuldeep과 저장소 소유자에게 전송합니다.

GitHub 저장소 (Lovable이 동기화하는 저장소)를 열어주세요.
Go to 설정 → 비밀 및 변수 → 작업
Click 새 저장소 비밀
이름: CAPGO_TOKEN
값: Step 1에서 Capgo API 키를 붙여넣으세요.
Save

GitHub은 비밀을 워크플로우에 주입합니다. ${{ secrets.CAPGO_TOKEN }}다음 워크플로우는 __CAPGO_KEEP_0__의 __CAPGO_KEEP_1__을 환경 변수로 읽습니다. CAPGO_TOKEN environment variable for the Capgo CLI.

그들의 리포지토리에서만 __CAPGO_KEEP_0__ 키가 필요합니다. Step 3 — __CAPGO_KEEP_0__ Actions 워크플로우에 추가하기 repo. You only need the key in GitHub, not in Lovable settings.

Step 3 — Add the GitHub Actions workflow

Lovable은 YAML을 추가하고 다음 Publish에서 푸시합니다.

Option B — 파일을 직접 추가하세요 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.

파일 생성

__CAPGO_KEEP_0__

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

업데이트하고 푸시하세요. 첫 번째 실행은 GitHub이 푸시를 받은 즉시 시작됩니다.

Vite base path: 사용자가 Native Shell 내부에서 자산을 로드해야 하는 경우가 종종 있습니다. 사용자가 OTA 업데이트 후 흰 화면을 보는 경우, 다시 배포하고 워크플로우를 재배포하세요. base: './' 암호화된 번들: vite.config.ts Cloudflare baseCapacitor

GitHub Capgo Capgo encryptionSDK CAPGO_PRIVATE_KEY as a second GitHub secret and pass --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" __CAPGO_KEEP_0__ 업로드 단계에서.

Step 4 — Confirm Publish는 배포를 트리거합니다.

Lovable에서 작은 변경 사항을 만들 수 있습니다 (예를 들어 버튼 레이블 텍스트).
Click 게시
GitHub에서 GitHub를 열어 Actions 및 __CAPGO_KEEP_0__ Live Updates를 관찰하십시오. 작업이 녹색이면 Capgo 콘솔을 열어
__CAPGO_KEEP_0__에서 새로운 번들을 확인하십시오. Capgo는 Capgo의 Capgo입니다. __CAPGO_KEEP_0__는 __CAPGO_KEEP_0__의 __CAPGO_KEEP_0__입니다. production channel
__CAPGO_KEEP_0__

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

Troubleshooting

증상	원인	해결
Workflow가 실행되지 않습니다	Push는 __CAPGO_KEEP_1__ 이외의 branch로 가게되었습니다 `main`	__CAPGO_KEEP_0__ `branches` __CAPGO_KEEP_1__ 업데이트를 받습니다 `main`
`CAPGO_TOKEN` / 인증 오류	비밀번호가 없거나 이름이 잘못되었습니다.	비밀번호가 정확히 `CAPGO_TOKEN` 액션 비밀번호
빌드가 `npm ci`	락파일이 동기화되지 않았습니다.	로컬에서 `npm install` , 다시 `package-lock.json`업로드 성공, 흰 화면
잘못된	또는 Vite `webDir` or Vite `base`	Match `capacitor.config.ts` `webDir` 를 빌드 출력 (`dist` Vite) 에서 설정하고 `base: './'`
사용자는 업데이트를 보지 못합니다	채널이 사용자의 빌드와 연결되지 않았습니다	Capgo 에서 장치 빌드를 `production` 공개 채널로 설정하거나

워크플로우 패턴 (기능 branch, PR 채널, 암호화) 에 대해 더 알아보세요 ( GitHub Actions 통합).

클라이언트에게 말하는 것

클라이언트에게 이 체크리스트를 보내세요 (

__CAPGO_KEEP_0__ 이미 연결된 Lovable과 GitHub을 설정하고 모바일 앱에서 Capgo을 설정했습니다.
그들은 GitHub 비밀번호를 하나만 추가합니다. CAPGO_TOKEN Capgo API 키 (apikeys 페이지).
그들은 클릭 게시 Lovable에서 사용자가 변경을 받을 때마다 사용자에게 변경을 받도록 하기 위해.
그들은 npx @capgo/cli 로컬에서 실행하지 않습니다. 그들은 그것을 원할 때만 합니다.

그것은 그들이 요청한 단일 클릭 경험과 일치합니다: Lovable에서 게시하는 버튼; GitHub Actions과 Capgo은 나머지 작업을 처리합니다.

__CAPGO_KEEP_0__

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

Lovable에서 Capgo Live 업데이트를 자동화하세요. GitHub 액션으로

pipeline이 어떻게 작동하는지

Step 1 — Capgo API 키를 생성하세요.

Step 2 — 추가 CAPGO_TOKEN GitHub (환경 설정 단계에서만 사용합니다.)

Step 3 — Add the GitHub Actions workflow

Lovable은 YAML을 추가하고 다음 Publish에서 푸시합니다.

__CAPGO_KEEP_0__

Step 4 — Confirm Publish는 배포를 트리거합니다.

Troubleshooting

클라이언트에게 말하는 것

__CAPGO_KEEP_0__

Step 2 — 추가 `CAPGO_TOKEN` GitHub (환경 설정 단계에서만 사용합니다.)