본문 바로가기

Bolt 빌더라면: Mac, Xcode 필요 없음

Bolt 앱을 iOS 및 Android 앱으로 전환하세요

Bolt 프로젝트를 export한 뒤 Capacitor로 감싸고, Capgo Build로 App Store와 Google Play용 서명된 앱을 빌드하세요. Mac은 필요 없습니다. 출시 후 Bolt에서 변경한 내용은 라이브 업데이트로 설치된 앱에 반영됩니다.

Mac 없음
iOS 빌드에 필요
iOS + Android
네이티브 플랫폼
Live Update
Bolt에서 변경한 사항

Bolt 프로젝트

Bolt에서 프롬프트로 웹 앱을 빌드하세요. GitHub를 연결해 code가 레포지토리에 있도록 하세요.

내보내고 래핑

Capacitor 셸

Capacitor를 사용해 static dist 폴더를 빌드하고 iOS와 Android 프로젝트를 추가하세요.

빌드 및 업데이트

Capgo 릴리스 루프

Capgo Build로 서명된 바이너리를 빌드한 다음, GitHub Actions에서 웹 변경 사항을 Live Updates로 배포하세요.

문제점

Bolt는 앱을 만듭니다. 스토어에는 더 많은 것이 필요합니다.

브라우저에서 멈춰버리는 앱

Bolt 프로젝트는 웹 앱입니다. 스토어 등록, 푸시 알림, 기기 기능에는 이를 감싸는 네이티브 셸이 필요합니다.

Bolt는 네이티브 툴링을 실행할 수 없습니다

서명, Xcode, Android Studio, 스토어 업로드는 Bolt 외부에서 이루어집니다. code와 빌드 서비스가 필요합니다.

모든 변경 사항은 리뷰를 기다립니다

첫 스토어 출시 이후 새 버전은 매번 스토어 심사를 다시 거쳐야 하며, 보통 24~48시간, 때로는 훨씬 더 오래 걸립니다.

기술 스택

도구별 역할

Bolt가 웹 앱을 빌드합니다

프롬프트로 화면, 플로우, 카피, 백엔드 연결을 반복 개선합니다. 프로덕션 빌드가 래핑할 정적 dist 폴더를 만들어 줍니다.

Capacitor가 래핑

Capacitor는 빌드된 웹 앱을 앱 ID, 아이콘, 권한과 함께 네이티브 iOS 및 Android 프로젝트에 넣습니다. code은 그대로 유지됩니다.

Capgo가 빌드 및 업데이트

Capgo Build는 서명된 바이너리를 생성해 스토어에 업로드합니다. Live Updates는 이후 웹 변경 사항을 설치된 앱에 배포합니다.

솔루션

Bolt에서 스토어까지, Capgo가 안내하는 경로

Bolt는 제품을 계속 빌드하고, Capacitor와 Capgo가 Native Build, 스토어 업로드, 업데이트 단계를 추가합니다.

GitHub 연결하고 클론하기

Bolt에서 GitHub 레포지토리를 연결하거나 프로젝트를 다운로드하세요. 클론한 뒤 빌드 시 index.html이 포함된 dist 폴더가 생성되는지 확인하세요.

Capgo Build로 빌드하기

CLI에서 서명된 iOS 및 Android 빌드를 요청하세요. iOS 빌드는 클라우드 Mac에서 실행되며, 라이브 로그를 통해 빌드 진행 상황을 실시간으로 확인할 수 있습니다.

각 변경 사항을 live update로 배포하세요

GitHub 레포지토리가 연결되면 Bolt에서 변경한 내용이 레포지토리에 커밋으로 푸시됩니다. GitHub Action이 앱을 빌드하고 번들을 업로드하므로, 설치된 앱은 새 스토어 릴리스 없이 웹 변경 사항을 받을 수 있습니다.

AI 에이전트가 릴리스를 실행하게 하세요

Capgo MCP 서버를 사용하면 Claude Code, Codex 또는 Cursor가 bundle을 upload하고, channel을 관리하며, 빌드를 요청할 수 있습니다. Capgo 스킬을 통해 에이전트에게 Capgo 전용 지침을 추가할 수 있습니다.

작동 방식

Bolt 빌더가 Capgo로 모바일 앱을 배포하는 방법

Bolt 프로젝트에서 스토어 빌드와 라이브 업데이트까지. 이 명령어들은 직접 실행하거나 코딩 에이전트에게 맡길 수 있습니다.

  1. GitHub 연결하고 클론하기

    Bolt에서 GitHub 레포지토리를 연결하거나 프로젝트를 다운로드하세요. 클론한 뒤 빌드 시 index.html이 포함된 dist 폴더가 생성되는지 확인하세요.

    git clone https://github.com/you/your-bolt-app.git
    cd your-bolt-app
    npm install
    npm run build
    Bolt → Capacitor 튜토리얼
  2. Capacitor 및 Capgo 추가

    네이티브 프로젝트를 추가한 다음 Capgo onboarding을 실행하세요. 앱이 추가되고 프로덕션 채널이 생성되며 updater plugin이 설치됩니다.

    npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
    npx cap init "Your App" com.company.app --web-dir dist
    npx cap add ios && npx cap add android
    npx @capgo/cli@latest init
    CLI onboarding 가이드
  3. 클라우드에서 서명된 앱 빌드

    서명 설정을 한 번만 완료하면 iOS 및 Android 빌드를 요청할 수 있습니다. 서명된 빌드는 App Store Connect와 Google Play에 업로드되어 심사를 받습니다.

    npx @capgo/cli@latest build init
    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Build 문서
  4. 각 변경 사항을 live update로 배포하세요

    CAPGO_TOKEN을 GitHub secret으로 추가하고, push할 때 빌드와 업로드를 수행하는 workflow를 설정하세요. 새 플러그인이나 권한은 여전히 새 스토어 빌드가 필요합니다.

    # step in .github/workflows, with CAPGO_TOKEN from secrets
    npm ci && npm run build
    npx @capgo/cli@latest bundle upload --channel=production --auto-bump
    GitHub Actions 연동

AI 에이전트 프롬프트

코딩 에이전트에게 설정을 맡기세요

Bolt code가 준비되면, Claude Code, Codex, Cursor 같은 코딩 에이전트에 이 내용을 붙여넣으세요. 그러면 Capgo MCP 서버가 설치되고, Capacitor와 updater가 추가되며, secret을 임의로 만들어내지 않고 서명용 TODO가 남습니다.

코딩 에이전트용 프롬프트

I want this project, exported from Bolt, to become a Capacitor mobile app using Capgo from the start.

Set up the project so an AI agent can use Capgo's MCP release tools through install-mcp:

1. Install the Capgo CLI MCP server for the active AI client. For Codex, run:
   - npx @capgo/cli@latest login
   - npx install-mcp 'npx @capgo/cli@latest mcp' --client codex
   Replace codex with cursor, claude-code, gemini-cli, or windsurf if that is the client this project uses.
2. Read Capgo's MCP metadata when tool details are needed (the hosted server is https://api.capgo.app/mcp):
   - https://capgo.app/.well-known/mcp/server-card.json
   - https://capgo.app/.well-known/agent-skills/capgo-cli-mcp/SKILL.md
   If this client supports agent skills, also run: npx skills add Cap-go/capgo-skills
3. Add a short docs/agent-mobile-release.md file that tells the agent to use the Capgo CLI MCP server as a local stdio server, not a remote HTTP endpoint.
4. Add Capacitor for iOS and Android using the package manager already used by this project.
5. Configure capacitor.config.ts with:
   - appName: the current Bolt app name
   - appId: a production-style bundle ID I can edit later, such as com.company.app
   - webDir: the production build output folder (usually dist)
   - plugins.CapacitorUpdater.defaultChannel: production
6. Install and configure @capgo/capacitor-updater.
7. Add package scripts for:
   - building the web app
   - syncing Capacitor
   - uploading a production Capgo bundle
   - starting Capgo Build setup for iOS
   - requesting an iOS cloud build
8. Create a first production channel plan:
   - production for users
   - preview for stakeholder review
   - staging for internal testing
9. Keep normal docs and README commands copy-pasteable with npm/npx unless this project already uses another package manager. Keep the Capgo MCP install command exactly as shown above.
10. Do not fake native signing credentials. Leave clear TODOs for the Capgo API key, Apple team details, and bundle ID.
11. After making changes, summarize exactly what changed and what command I should run next.

Capacitor로 빌드된 앱

템플릿과 학습용 제품은 모바일 앱으로 만들기 좋은 후보입니다

창작 및 학습용 앱은 패키징, 서명, 업데이트가 깔끔하게 처리되면 웹 스타일의 흐름이 어떻게 스토어 출시 가능한 모바일 경험으로 바뀔 수 있는지 보여줍니다.

Invitation Maker Card Design 앱 아이콘 이벤트

초대장 제작 카드 디자인

반응형 웹에서 모바일로 자연스럽게 이어지는 템플릿 기반 디자인 워크플로우.

Google Play 설치 수
2,000만
스토어 평점
4.6
Infinite Japanese 앱 아이콘 교육용

무한한 일본어

작은 레슨과 onboarding 개선이 쌓여 큰 효과를 내는 집중 학습 앱.

Google Play 설치 수
180만
스토어 평점
4.6
StudySmarter - 학교 및 대학 앱 아이콘 교육

StudySmarter - 학교 및 대학교

앱 패키징 후에도 웹 제품 이터레이션을 계속할 수 있는 워크플로우를 살펴보세요.

Google Play 설치 수
650만
스토어 평점
4.8

고객 사례

Capgo로 배포하는 팀들의 이야기

5.0/5 개발 팀 평점 9,400+ 팀 리뷰 보기

sikafanka

디자인, radius 5

“Capgo Build 덕분에 Capacitor 앱 출시 프로세스가 훨씬 간단해졌습니다. 하나의 명확한 워크플로우에서 iOS와 Android 앱을 빌드하고 출시할 수 있습니다.”

카필

NuTriQ 창립자

“App Store의 전체 리뷰 주기를 기다리지 않고 프로덕션 OTA 업데이트를 즉시 푸시할 수 있다는 점은 운영상 엄청난 이점이었습니다.”

Luis Dominguez의 사진

루이스 도밍게스

돈을 내는 사람이 주인이다

“Capgo를 쓰기 시작한 뒤로 모든 게 더 빨라졌고, 일상도 놓치지 않으면서 사용자에게 마땅히 줘야 할 시간을 쓸 수 있게 됐습니다.”

자주 묻는 질문

Bolt 빌더들이 묻는 질문

Bolt 앱을 App Store와 Google Play에 출시할 때 필요한 짧은 답변.

Bolt에서 App Store로 바로 배포할 수 있나요?

아니요. Bolt는 웹 앱을 빌드합니다. code를 export한 뒤 Capacitor로 감싸고, Capgo Build로 서명된 iOS 및 Android 앱을 빌드하면 App Store Connect와 Google Play에 업로드됩니다.

Bolt → Capacitor 튜토리얼

Mac이나 Xcode가 필요한가요?

아니요. Capgo Build는 클라우드 Mac 머신에서 iOS 빌드를 실행합니다. 다만 App Store를 위한 Apple Developer 계정과 Android를 위한 Google Play 개발자 계정은 필요합니다.

Capgo Build 문서

모든 Bolt 프로젝트에서 작동하나요?

Bolt 프로젝트는 주로 Vite 앱이므로 dist를 webDir로 지정하면 됩니다. Next.js 프로젝트라면 static export를 사용하고 webDir를 out으로 지정하세요.

Bolt GitHub 문서

Bolt는 Expo 앱도 지원합니다. 왜 Capacitor를 사용해야 할까요?

Capacitor는 Bolt에서 이미 만든 웹 앱을 그대로 유지합니다. Expo를 쓰면 React Native로 UI를 다시 만들어야 합니다. Capacitor을 사용하면 동일한 code가 웹, iOS, Android에서 실행됩니다.

Capgo vs Expo

Bolt에서 변경한 내용이 모바일 앱에 반영되나요?

GitHub 리포지토리가 연결되어 있으면 Bolt에서 변경한 내용이 리포지토리에 커밋으로 푸시됩니다. 웹 레이어 변경이라면 그렇습니다. GitHub Action이 푸시할 때마다 bundle 업로드를 실행하고, 설치된 앱이 업데이트를 다운로드합니다. 새 플러그인이나 권한은 여전히 새 스토어 빌드가 필요합니다.

GitHub Actions 연동

AI 에이전트가 릴리스 단계를 처리할 수 있나요?

네. npx @capgo/cli mcp가 로컬 MCP 서버를 시작하면 Claude Code, Codex, Cursor에서 bundle 업로드, 채널 관리, 빌드 요청에 사용할 수 있습니다. Capgo 스킬은 에이전트에 Capgo 전용 지침을 추가합니다.

Capgo MCP 서버

Bolt 앱을 스토어에 출시하세요

14일 무료 트라이얼을 시작하고 Bolt 프로젝트를 내보낸 후, CLI에서 첫 번째 iOS 및 Android 빌드를 요청하세요. 14일 환불 보장 플랜을 선택하고 Bolt 프로젝트를 내보낸 후, CLI에서 첫 번째 iOS 및 Android 빌드를 요청하세요.