Capgo Capgo Live Updates를 Lovable과 함께 GitHub Actions로 자동화하세요

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

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

__CAPGO_KEEP_0__의 실시간 업데이트를 자동화하는 또 다른 터미널 명령어는 필요하지 않습니다. Lovable은 Capgo을 Publish 시 실행할 수 없습니다. GitHub 동기화가 활성화되면, Push를 푸시하여 저장소에 커밋합니다.. GitHub Actions는 빌드와 bundle upload 를 실행합니다.

이 안내서에서는 클라이언트가 한 번만 수행해야 하는 수동 설정에 대해 다룹니다: CAPGO_TOKEN as a GitHub secret. For the workflow file, copy-paste the ready AI instruction into Lovable (Step 3).

으로 추가합니다. 워크플로 파일에 대해, Lovable (Step 3)에 AI 지침을 복사-붙여넣습니다.

pipeline의 동작	Step	누구
1	무엇이 발생하는가	클라이언트 Lovable에서 앱을 편집하고 Publish 버튼을 클릭합니다.
2	Lovable	GitHub의 커밋과 푸시 `main`)
3	GitHub 액션	`npm ci`, `npm run build`, `bundle upload --auto-bump` Capgo
4	Capgo	__CAPGO_KEEP_0__ `production` __CAPGO_KEEP_0__

CLI

__CAPGO_KEEP_0__

GitHub__CAPGO_KEEP_0__)
Capacitor @capgo/capacitor-updater 저장소 (Lovable to 모바일 가이드 )
Capgo에 앱이 등록되어 capacitor.config.ts 정확한 appId
production 채널이 존재하고 빌드에 연결되어

왜 `--auto-bump`

Capgo 업로드는 항상 새로운 버전을 필요로 합니다. package.json Lovable Publish는 버전을

--auto-bump 자동으로 minor증가시켜주지 않습니다. 따라서 CI는 동일한 버전을 다시 사용할 경우 두 번째 배포 시 실패합니다. --auto-bump patch 또는 --auto-bump major 만약에

1단계 — Capgo API 키를 생성하세요

열기 console.capgo.app/apikeys/
API 키를 생성하세요. 이 키는 앱에 업로드할 패키지를 업로드할 수 있는 권한이 있습니다.
이 키를 복사하세요. 이 키의 전체 값을 다시 보지 못합니다.

이 키를 암호로 다루세요. Git에 커밋하지 마세요. 또는 Lovable 채팅에 붙여넣지 마세요.

2단계 — 추가 `CAPGO_TOKEN` GitHub (단 하나의 환경 설정 단계)

이 단계를 Kuldeep과 리포지토리를 소유한 클라이언트에게 보세요.

GitHub 리포지토리를 열어보세요. Lovable이 동기화하는 리포지토리입니다.
Go to 설정 → 비밀 및 변수 → 액션
클릭 새 레포지토리 비밀
이름: CAPGO_TOKEN
값: 1단계에서 Capgo API 키를 붙여넣으세요
저장

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

만약 리포가 고객사의 조직 하위에 있다면, 그들은 __CAPGO_KEEP_0__에 있는 비밀을 추가해야 합니다. 그들의 repo. You only need the key in GitHub, not in Lovable settings.

3단계 — Lovable에 이 프롬프트를 붙여넣기

아래 블록을 Lovable 채팅에 복사하세요. 만약 기본 branch가 __CAPGO_KEEP_0__가 아니라면, workflow에 branch 이름을 대체하세요. mainLovable가 변경을 적용한 후, __CAPGO_KEEP_0__에 workflow를 게시하기 위해 main 게시

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.

클릭하세요. 수동 대안 so the workflow lands on GitHub.

을 생성하세요.

If you prefer not to use the Lovable chat, create .github/workflows/capgo-live-updates.yml 이 YAML만 사용하세요 (설명은 제외합니다). 설치/빌드 단계를 프로젝트에 맞게 조정하고, 커밋하고 푸시하세요.

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: Lovable Vite 앱은 종종 base: './' in vite.config.ts 자연스러운 native shell 내에서 자산을 로드해야 합니다. OTA 업데이트 후 백색 화면이 나타나면 Lovable에게 base: './'publish 다시하고, 워크플로우가 다시 배포되도록 해주세요.

암호화된 패키지: Capacitor Capgo encryption__CAPGO_KEEP_0__ 암호화 CAPGO_PRIVATE_KEY 를 사용하는 경우 두 번째 GitHub 비밀을 추가하고 --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" 업로드 단계에서.

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

로블로블(Lovable)에서, 작은 변경 사항을 만들 수 있습니다 (예를 들어 버튼 레이블 텍스트)
클릭 게시
GitHub에서, 액션 그리고 Capgo Live Updates
페이지/영역: Live updates 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보는 곳: 페이지 live-update.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하십시오. 메시지 키 `live_update_hero_badge` (Live Update Hero Badge). Capgo console __CAPGO_KEEP_0__ 콘솔을 열고, 새로운 번들을 확인합니다. production 채널
설치된 기기에 변경이 도착하는지 확인하세요 (채널 설정에 따라 1분 정도 걸릴 수 있습니다)

✅ 성공: Lovable에서 게시 → 녹색 GitHub Action → 새로운 Capgo 패키지 → 사용자에게 업데이트가 전달됩니다.

문제 해결

증상	가능한 원인	수정
워크플로가 실행되지 않음	다른 branch로 푸시가 갔습니다. `main`	변경 `branches` 워크플로 또는 게시 `main`
`CAPGO_TOKEN` / 인증 오류	비밀번호가 없거나 이름이 잘못되었습니다.	비밀번호가 정확히 1개여야 합니다. `CAPGO_TOKEN` Actions 비밀번호 아래에 있습니다.
버전이 이미 존재합니다.	업로드는 동일한 버전의 패키지를 재사용했습니다.	__CAPGO_KEEP_0__ `--auto-bump` 업로드 단계에서 __CAPGO_KEEP_1__ (또는 __CAPGO_KEEP_1__를 통과) `--auto-bump patch`)
빌드가 __CAPGO_KEEP_2__에서 실패했습니다. `npm ci`	__CAPGO_KEEP_3__가 동기화되지 않았습니다.	__CAPGO_KEEP_4__ `npm install` 로컬에서 __CAPGO_KEEP_5__, 커밋 `package-lock.json`다시 업로드 하세요
업로드 성공, 흰 화면	틀리다 `webDir` 또는 Vite `base`	일치 `capacitor.config.ts` `webDir` 빌드 출력 (`dist` Vite)과 설정 `base: './'`
사용자는 업데이트를 보지 못합니다	채널이 사용자의 빌드에 연결되지 않았습니다	Capgo에서 장치 빌드를 연결하세요 `production` 또는 채널을 공개로 설정하세요

더 많은 워크플로우 패턴 (기능 branch, PR 채널, 암호화) 에 대해서는 GitHub Actions integration.

__CAPGO_KEEP_0__

그들은 already connected Lovable to GitHub and set up Capgo on the mobile app.
__CAPGO_KEEP_0__ add one GitHub secret: CAPGO_TOKEN with their Capgo API key (발행).
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ __CAPGO_KEEP_0__ Lovable에서 언제든지 변경을 받기를 원하는 사용자에게 변경을 받게 합니다.
그들은 절대 실행되지 않습니다. npx @capgo/cli 그들은 로컬에서 실행되지 않습니다. 그들이 원한다면.

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

계속 진행하세요.

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

Capgo의 실시간 업데이트를 GitHub Actions로 자동화하세요.