software-mansion-labs/goldie

Goldie – 자동화된 App Store 및 Google Play 스크린샷 및 미리보기 생성기

이것이 무엇인가 Goldie는 iOS App Store 및 Android Google Play 리스팅을 위한 마케팅 자산(스크린샷, 기기 프레임 이미지, 짧은 미리보기 비디오) 생성을 자동화하는 명령줄 도구입니다. iOS 시뮬레이터 또는 Android 에뮬레이터(동반 도구 Argent를 통해)에서 UI 흐름을 재생하고, 화면을 캡처하고, 기기 베젤, 배경, 헤드라인 및 레이아웃을 추가하고, 마지막으로 모든 것을 스토어 준비 비디오로 결합합니다. 전체 파이프라인은 수동으로 또는 흐름 스크립트와 구성을 작성하는 코딩 에이전트(예: Cursor, Claude Code, Codex)를 통해 구동할 수 있습니다.

주요 기능

기능	세부 사항
크로스 플랫폼	SwiftUI, UIKit, Jetpack Compose, Flutter, React Native, Kotlin Multiplatform 등 모든 모바일 프레임워크와 호환됩니다.
시뮬레이터/에뮬레이터 기반	Argent를 사용하여 iOS 시뮬레이터(macOS 전용) 또는 Android 에뮬레이터(macOS, Linux, Windows)에서 사전 녹화된 흐름을 재생합니다.
기기 프레임 및 테마	실제 기기 베젤(iPhone 17-pro, iPad-13, Pixel 10 Pro 등), 사용자 지정 배경, 글꼴 및 레이아웃 템플릿(에디토리얼, 쇼케이스, 매거진, 스토리보드 등)을 추가합니다.
로케일 인식 스크린샷	기본적으로 모든 로케일에 대해 한 세트의 캡처를 생성합니다. 선택적 `localizedCaptures` 플래그는 언어별로 다시 캡처합니다.
미리보기 비디오 생성	App Store 미리보기 요구 사항을 충족하는 15-30초 H.264 비디오를 생성합니다. Google Play용 세로 프로모션 비디오도 생성합니다.
CLI 워크플로	`goldie doctor`(환경 확인), `goldie all`(전체 파이프라인), `goldie studio`(자산을 조정하는 브라우저 UI).
AI 에이전트 친화적	"skills" 형식을 지원하는 모든 코딩 에이전트 플랫폼에 추가할 수 있는 스킬을 제공하여 에이전트가 "goldie를 사용하여 앱 스토어 스크린샷 생성"과 같은 자연어 명령을 실행할 수 있게 합니다.
구성 기반	모든 설정은 TypeScript 구성(`goldie.config.ts`)에 있습니다 – 기기, 로케일, 프레임 스타일, 테마, 사용자 지정 글꼴, 장식, Android APK 경로 등.

설치 및 사전 요구 사항

# Node 20+ 및 ffmpeg가 PATH에 있어야 합니다.
npm i -g goldie

iOS – Xcode가 있는 macOS(iOS 시뮬레이터).
Android – Android 에뮬레이터; Linux에서는 추가 패키지가 필요할 수 있습니다(Argent 문서 참조).
선택 사항 – 코딩 에이전트에 스킬 추가:

npx skills add kacperkapusciak/goldie   # Cursor, Codex 등
/plugin marketplace add kacperkapusciak/goldie   # Claude Code
/plugin install goldie@goldie

일반적인 워크플로

구성 생성 – goldie.config.example.ts를 goldie.config.ts로 복사하고 각 씬을 Argent 흐름 파일(.argent/flows/...)에 연결합니다.
진단 실행 – goldie doctor는 시뮬레이터/에뮬레이터 및 흐름에 접근 가능한지 확인합니다.
자산 생성 – goldie all은 캡처, 프레임, 미리보기 렌더링 및 스토어 업로드 규칙에 대한 검증을 수행합니다.
미세 조정 – goldie studio는 기기, 배경, 글꼴 및 카피를 전환할 수 있는 로컬 웹 UI를 엽니다. 변경 사항은 재현성을 위해 goldie.design.json에 저장됩니다.
출력 찾기 – 스크린샷은 out/screenshots/<device>/<locale>/에, 비디오는 out/previews/<device>/<locale>/에 있습니다.

AI/코딩 에이전트와의 연계

Goldie 자체는 AI 모델이 아니지만 에이전트 준비가 되도록 설계되었습니다. 저장소에는 여러 LLM 기반 코딩 어시스턴트에서 사용하는 일반적인 "skills" 형식을 따르는 스킬이 포함되어 있습니다. 에이전트가 자연어 요청(예: "goldie를 사용하여 앱 스토어 스크린샷 생성")을 받으면 다음을 수행할 수 있습니다:

개발자에게 대상 스토어 및 로케일을 선택하도록 요청합니다.
goldie.config.ts 및 기본 Argent 흐름 스크립트를 자동 생성하거나 업데이트합니다.
CLI(goldie all)를 호출하고 생성된 자산을 사용자에게 다시 제시합니다. 따라서 Goldie는 LLM 기반 코딩 워크플로와 앱 스토어 마케팅에 필요한 구체적이고 플랫폼별 자산 사이의 브리지 역할을 합니다.

누가 사용할까요?

스토어 준수 스크린샷 및 미리보기 비디오 생성의 지루한 과정을 자동화하려는 모바일 개발자.
이미 AI 코딩 어시스턴트를 사용하고 있으며 어시스턴트가 전체 자산 파이프라인을 처리하도록 하려는 팀.
여러 클라이언트 앱에 대해 반복 가능하고 사용자 지정 가능한 솔루션이 필요한 에이전시(예: Software Mansion).

후원

Goldie는 기본 흐름 재생 엔진 Argent의 제작사인 Software Mansion이 개발하고 후원합니다.