브라우저에서 멈춰버리는 앱
Replit 프로젝트는 웹 앱입니다. 스토어 등록, 푸시 알림, 디바이스 기능에는 이를 감싸는 네이티브 셸이 필요합니다.
Replit 빌더용: Mac도 Xcode도 필요 없음
Replit 프로젝트를 export하고 Capacitor로 감싼 다음, Capgo Build로 App Store와 Google Play용 서명된 앱을 빌드하세요. Mac은 필요 없습니다. 출시 후 Replit에서 변경한 내용은 Live Updates를 통해 설치된 앱에 반영됩니다.
14일간 무제한 무료 체험. 카드 등록 불필요 14일 이내 환불 보장. 언제든 취소 가능.
Replit 프로젝트
Replit Agent로 앱을 빌드하세요. Shell을 사용하거나 Git 패널에서 GitHub를 연결하세요.
내보내고 래핑
Capacitor 셸
Capacitor를 사용해 static dist 폴더를 빌드하고 iOS와 Android 프로젝트를 추가하세요.
빌드 및 업데이트
Capgo 릴리스 루프
Capgo Build로 서명된 바이너리를 빌드한 다음, GitHub Actions에서 웹 변경 사항을 Live Updates로 배포하세요.
문제점
Replit 프로젝트는 웹 앱입니다. 스토어 등록, 푸시 알림, 디바이스 기능에는 이를 감싸는 네이티브 셸이 필요합니다.
서명, Xcode, Android Studio, 스토어 업로드는 Replit 외부에서 이루어집니다. code와 빌드 서비스가 필요합니다.
첫 스토어 출시 이후 새 버전은 매번 스토어 심사를 다시 거쳐야 하며, 보통 24~48시간, 때로는 훨씬 더 오래 걸립니다.
기술 스택
프롬프트로 화면, 플로우, 카피, 백엔드 연결을 반복 개선합니다. 프로덕션 빌드가 래핑할 정적 dist 폴더를 만들어 줍니다.
Capacitor는 빌드된 웹 앱을 앱 ID, 아이콘, 권한과 함께 네이티브 iOS 및 Android 프로젝트에 넣습니다. code은 그대로 유지됩니다.
Capgo Build는 서명된 바이너리를 생성해 스토어에 업로드합니다. Live Updates는 이후 웹 변경 사항을 설치된 앱에 배포합니다.
솔루션
Replit은 제품 빌드에만 집중하세요. Capacitor와 Capgo가 Native Build, 스토어 upload, 그리고 update 단계를 완성합니다.
Replit은 Shell을 제공하므로 모든 단계를 거기서 실행할 수 있습니다. 또는 Git 패널에서 GitHub를 연결해 repo를 clone하세요. 한 번 빌드한 뒤 index.html이 있는 폴더를 찾으세요.
CLI에서 서명된 iOS 및 Android 빌드를 요청하세요. iOS 빌드는 클라우드 Mac에서 실행되며, 보통 2~3분이면 완료됩니다.
Replit Git 패널에서 repo로 push하거나 Shell에서 바로 upload 명령을 실행하세요. GitHub Action이 앱을 빌드하고 bundle을 upload하므로, 스토어에 새로 릴리스하지 않아도 설치된 앱에 웹 변경 사항이 반영됩니다.
Capgo MCP 서버를 사용하면 Claude Code, Codex 또는 Cursor가 bundle을 upload하고, channel을 관리하며, 빌드를 요청할 수 있습니다. Capgo 스킬을 통해 에이전트에게 Capgo 전용 지침을 추가할 수 있습니다.
작동 방식
Replit 프로젝트에서 빌드 및 Live Update 저장까지. 직접 명령어를 실행하거나 코딩 에이전트가 실행하도록 할 수 있습니다.
Replit은 Shell을 제공하므로 모든 단계를 거기서 실행할 수 있습니다. 또는 Git 패널에서 GitHub를 연결해 repo를 clone하세요. 한 번 빌드한 뒤 index.html이 있는 폴더를 찾으세요.
npm install
npm run build
ls dist # full-stack templates may use dist/public Web app을 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 빌드 문서 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 에이전트 프롬프트
Replit code 준비가 끝나면, Claude Code, Codex 또는 Cursor 같은 코딩 에이전트에 이 내용을 붙여넣으세요. 그러면 Capgo MCP 서버가 설치되고, Capacitor와 updater가 추가되며, secret을 임의로 만들어내는 대신 서명용 TODO를 남겨둡니다.
코딩 에이전트용 프롬프트
I want this project, exported from Replit, 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 Replit 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를 쓰기 시작한 뒤로 모든 게 더 빨라졌고, 일상도 놓치지 않으면서 사용자에게 마땅히 줘야 할 시간을 쓸 수 있게 됐습니다.”
자주 묻는 질문
Replit 앱을 App Store와 Google Play에 출시하기 위한 짧은 답변입니다.
아니요. Replit은 웹 앱을 빌드합니다. code를 export한 뒤 Capacitor로 래핑하세요. 그 다음 Capgo Build로 서명된 iOS 및 Android 앱을 빌드하면 App Store Connect와 Google Play에 업로드됩니다.
Web app을 Capacitor로 전환하는 가이드아니요. Capgo Build는 클라우드 Mac 머신에서 iOS 빌드를 실행합니다. 다만 App Store를 위한 Apple Developer 계정과 Android를 위한 Google Play 개발자 계정은 필요합니다.
Capgo 빌드 문서네. Capacitor는 프론트엔드 빌드만 배포합니다. 서버는 Replit에 배포된 상태로 두고, 앱에서 상대 경로 /api 대신 전체 https URL로 호출하세요.
네. Replit Shell은 npx @capgo/cli를 실행하므로 브라우저에서 빌드와 업로드가 작동합니다. Replit Shell에서 Capgo API 키로 npx @capgo/cli@latest login을 한 번 실행하세요.
Replit용 CapgoReplit Git 창에서 레포지토리로 Push하거나 Shell에서 바로 업로드 명령을 실행하세요. 웹 레이어 변경 사항이라면 가능합니다. GitHub Action이 Push할 때마다 bundle 업로드를 실행하고, 설치된 앱은 업데이트를 다운로드합니다. 새 plugin이나 권한은 여전히 새 스토어 빌드가 필요합니다.
GitHub Actions 연동네. npx @capgo/cli mcp가 로컬 MCP 서버를 시작하면 Claude Code, Codex, Cursor에서 bundle 업로드, 채널 관리, 빌드 요청에 사용할 수 있습니다. Capgo 스킬은 에이전트에 Capgo 전용 지침을 추가합니다.
Capgo MCP 서버14일 무료 체험을 시작하고, Replit 프로젝트를 내보낸 뒤 CLI에서 첫 iOS 및 Android 빌드를 요청하세요. 14일 환불 보장이 있는 플랜을 선택하고, Replit 프로젝트를 내보낸 뒤 CLI에서 첫 iOS 및 Android 빌드를 요청하세요.
Capgo Build로 Replit 앱을 iOS 및 Android 앱으로 바꾸세요.
Martin이 직접 제공하는 지원
14일간 무제한 무료 체험. 카드 등록 불필요 14일 이내 환불 보장. 언제든 취소 가능.