브라우저에서 멈춰버리는 앱
Bolt 프로젝트는 웹 앱입니다. 스토어 등록, 푸시 알림, 기기 기능에는 이를 감싸는 네이티브 셸이 필요합니다.
Bolt 빌더라면: Mac, Xcode 필요 없음
Bolt 프로젝트를 export한 뒤 Capacitor로 감싸고, Capgo Build로 App Store와 Google Play용 서명된 앱을 빌드하세요. Mac은 필요 없습니다. 출시 후 Bolt에서 변경한 내용은 라이브 업데이트로 설치된 앱에 반영됩니다.
14일간 무제한 무료 체험. 카드 등록 불필요 14일 환불 보장. 언제든 취소 가능.
Bolt 프로젝트
Bolt에서 프롬프트로 웹 앱을 빌드하세요. GitHub를 연결해 code가 레포지토리에 있도록 하세요.
내보내고 래핑
Capacitor 셸
Capacitor를 사용해 static dist 폴더를 빌드하고 iOS와 Android 프로젝트를 추가하세요.
빌드 및 업데이트
Capgo 릴리스 루프
Capgo Build로 서명된 바이너리를 빌드한 다음, GitHub Actions에서 웹 변경 사항을 Live Updates로 배포하세요.
문제점
Bolt 프로젝트는 웹 앱입니다. 스토어 등록, 푸시 알림, 기기 기능에는 이를 감싸는 네이티브 셸이 필요합니다.
서명, Xcode, Android Studio, 스토어 업로드는 Bolt 외부에서 이루어집니다. code와 빌드 서비스가 필요합니다.
첫 스토어 출시 이후 새 버전은 매번 스토어 심사를 다시 거쳐야 하며, 보통 24~48시간, 때로는 훨씬 더 오래 걸립니다.
기술 스택
프롬프트로 화면, 플로우, 카피, 백엔드 연결을 반복 개선합니다. 프로덕션 빌드가 래핑할 정적 dist 폴더를 만들어 줍니다.
Capacitor는 빌드된 웹 앱을 앱 ID, 아이콘, 권한과 함께 네이티브 iOS 및 Android 프로젝트에 넣습니다. code은 그대로 유지됩니다.
Capgo Build는 서명된 바이너리를 생성해 스토어에 업로드합니다. Live Updates는 이후 웹 변경 사항을 설치된 앱에 배포합니다.
솔루션
Bolt는 제품을 계속 빌드하고, Capacitor와 Capgo가 Native Build, 스토어 업로드, 업데이트 단계를 추가합니다.
Bolt에서 GitHub 레포지토리를 연결하거나 프로젝트를 다운로드하세요. 클론한 뒤 빌드 시 index.html이 포함된 dist 폴더가 생성되는지 확인하세요.
CLI에서 서명된 iOS 및 Android 빌드를 요청하세요. iOS 빌드는 클라우드 Mac에서 실행되며, 라이브 로그를 통해 빌드 진행 상황을 실시간으로 확인할 수 있습니다.
GitHub 레포지토리가 연결되면 Bolt에서 변경한 내용이 레포지토리에 커밋으로 푸시됩니다. GitHub Action이 앱을 빌드하고 번들을 업로드하므로, 설치된 앱은 새 스토어 릴리스 없이 웹 변경 사항을 받을 수 있습니다.
Capgo MCP 서버를 사용하면 Claude Code, Codex 또는 Cursor가 bundle을 upload하고, channel을 관리하며, 빌드를 요청할 수 있습니다. Capgo 스킬을 통해 에이전트에게 Capgo 전용 지침을 추가할 수 있습니다.
작동 방식
Bolt 프로젝트에서 스토어 빌드와 라이브 업데이트까지. 이 명령어들은 직접 실행하거나 코딩 에이전트에게 맡길 수 있습니다.
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 튜토리얼 네이티브 프로젝트를 추가한 다음 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 가이드 서명 설정을 한 번만 완료하면 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 문서 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로 빌드된 앱
창작 및 학습용 앱은 패키징, 서명, 업데이트가 깔끔하게 처리되면 웹 스타일의 흐름이 어떻게 스토어 출시 가능한 모바일 경험으로 바뀔 수 있는지 보여줍니다.
반응형 웹에서 모바일로 자연스럽게 이어지는 템플릿 기반 디자인 워크플로우.
작은 레슨과 onboarding 개선이 쌓여 큰 효과를 내는 집중 학습 앱.
앱 패키징 후에도 웹 제품 이터레이션을 계속할 수 있는 워크플로우를 살펴보세요.
디자인, radius 5
“Capgo Build 덕분에 Capacitor 앱 출시 프로세스가 훨씬 간단해졌습니다. 하나의 명확한 워크플로우에서 iOS와 Android 앱을 빌드하고 출시할 수 있습니다.”
NuTriQ 창립자
“App Store의 전체 리뷰 주기를 기다리지 않고 프로덕션 OTA 업데이트를 즉시 푸시할 수 있다는 점은 운영상 엄청난 이점이었습니다.”
돈을 내는 사람이 주인이다
“Capgo를 쓰기 시작한 뒤로 모든 게 더 빨라졌고, 일상도 놓치지 않으면서 사용자에게 마땅히 줘야 할 시간을 쓸 수 있게 됐습니다.”
자주 묻는 질문
Bolt 앱을 App Store와 Google Play에 출시할 때 필요한 짧은 답변.
아니요. Bolt는 웹 앱을 빌드합니다. code를 export한 뒤 Capacitor로 감싸고, Capgo Build로 서명된 iOS 및 Android 앱을 빌드하면 App Store Connect와 Google Play에 업로드됩니다.
Bolt → Capacitor 튜토리얼아니요. Capgo Build는 클라우드 Mac 머신에서 iOS 빌드를 실행합니다. 다만 App Store를 위한 Apple Developer 계정과 Android를 위한 Google Play 개발자 계정은 필요합니다.
Capgo Build 문서Bolt 프로젝트는 주로 Vite 앱이므로 dist를 webDir로 지정하면 됩니다. Next.js 프로젝트라면 static export를 사용하고 webDir를 out으로 지정하세요.
Bolt GitHub 문서Capacitor는 Bolt에서 이미 만든 웹 앱을 그대로 유지합니다. Expo를 쓰면 React Native로 UI를 다시 만들어야 합니다. Capacitor을 사용하면 동일한 code가 웹, iOS, Android에서 실행됩니다.
Capgo vs ExpoGitHub 리포지토리가 연결되어 있으면 Bolt에서 변경한 내용이 리포지토리에 커밋으로 푸시됩니다. 웹 레이어 변경이라면 그렇습니다. GitHub Action이 푸시할 때마다 bundle 업로드를 실행하고, 설치된 앱이 업데이트를 다운로드합니다. 새 플러그인이나 권한은 여전히 새 스토어 빌드가 필요합니다.
GitHub Actions 연동네. npx @capgo/cli mcp가 로컬 MCP 서버를 시작하면 Claude Code, Codex, Cursor에서 bundle 업로드, 채널 관리, 빌드 요청에 사용할 수 있습니다. Capgo 스킬은 에이전트에 Capgo 전용 지침을 추가합니다.
Capgo MCP 서버14일 무료 트라이얼을 시작하고 Bolt 프로젝트를 내보낸 후, CLI에서 첫 번째 iOS 및 Android 빌드를 요청하세요. 14일 환불 보장 플랜을 선택하고 Bolt 프로젝트를 내보낸 후, CLI에서 첫 번째 iOS 및 Android 빌드를 요청하세요.
Capgo Build로 Bolt 앱을 iOS 및 Android 앱으로 전환하세요.
Martin이 직접 제공하는 지원
14일간 무제한 무료 체험. 카드 등록 불필요 14일 환불 보장. 언제든 취소 가능.