Goldie, 앱스토어 스크린샷 자동 생성 CLI 공개

Goldie는 코딩 에이전트와 연동하여 앱스토어용 스크린샷과 미리보기 영상을 자동 생성하는 CLI 도구다. 이미지 생성 모델을 사용하는 기존 도구와 달리, Software Mansion의 argent를 활용해 iOS Simulator나 Android Emulator에서 실제 사용자 흐름을 재생하고 캡처한 화면을 기반으로 한다.

주요 기능 및 호환성

• 자동화 파이프라인: 캡처된 화면에 기기 테두리, 배경, 헤드라인을 합성하고 스토어 업로드 규격(픽셀 크기, 영상 길이 등)을 검증한다.
• 프레임워크 지원: SwiftUI, UIKit, Jetpack Compose, Flutter, React Native, Kotlin Multiplatform 등을 지원한다.
• 에이전트 연동: 저장소 내 설정 파일을 생성 및 수정하여 반복 작업을 자동화하며, Cursor, Codex, Claude Code 등과 연동 가능하다.

플랫폼별 산출물 및 제한 사항

• iOS: macOS(Xcode/iOS Simulator) 환경이 필수다. iPhone 17 Pro Max 기준 스크린샷은 1320x2868, 미리보기 영상은 886x1920 H.264 포맷으로 생성된다.
• Android: Linux/Windows에서도 Google Play 산출물 생성이 가능하나, devices 설정에서 pixel-10-pro만 유지해야 한다. Play Store는 영상 업로드가 불가하여 Goldie는 유튜브 게시용 세로 미리보기 영상을 렌더링한다.
• 주의사항: 디버그 빌드의 LogBox 배너 방지를 위해 릴리스 빌드 사용이 권장되며, 앱 변경 시 argent 흐름 재녹화나 에이전트 수리가 필요할 수 있다.

설치 및 사용

Node 20.12+와 ffmpeg이 필요하며, npm i -g goldie로 설치한다. goldie doctor로 환경을 점검한 후 goldie all로 전체 파이프라인을 실행하거나, goldie studio를 통해 브라우저 UI에서 디자인 옵션을 수정할 수 있다. MIT 라이선스로 개인 및 상업적 사용이 자유롭다.