goldie README

The project's README from github.com/software-mansion-labs/goldie. As one markdown file: README.md.

Goldie: App Store screenshot generator for coding agents (and humans)

goldie makes App Store and Google Play screenshots, and App Store preview videos, for a mobile app. argent replays flows on an iOS simulator or an Android emulator. goldie frames the captures with a device bezel, a background and a headline. It joins the clips into a preview video. It checks the result against the upload rules of the stores.

goldie is framework agnostic. It drives the app through the simulator or the emulator. It works the same for SwiftUI, UIKit, Jetpack Compose, Flutter, React Native and Kotlin Multiplatform apps.

Install

You need Node 20 or newer and ffmpeg on the PATH. App Store screenshots need macOS with iOS simulators (Xcode). Google Play screenshots need an Android emulator, which works on macOS, Linux and Windows. On Linux, argent needs a few extra packages for Android emulators. On a Linux or Windows machine keep only pixel-10-pro in devices; goldie doctor says so when an iOS device is configured on a host that cannot run it.

Install the CLI:

npm i -g goldie

Add the skill to your coding agent:

npx skills add kacperkapusciak/goldie            # Cursor, Codex, any agent

/plugin marketplace add kacperkapusciak/goldie   # Claude Code
/plugin install goldie@goldie

The skill works with all agents that support the skills format.

Use with a coding agent

Ask from your app repo:

create app store screenshots using goldie

The agent asks which stores to target. It explores the app, writes the flows and the config, and opens the studio. Follow-ups such as use a dark background edit the same files.

Use by hand

Copy goldie.config.example.ts to goldie.config.ts. Point its scenes at argent flows in .argent/flows. Then run:

goldie doctor     Check tools, simulators and flows
goldie all        Capture, frame, render the preview and verify
goldie studio     Preview and tweak the assets in the browser

The output goes to out/screenshots/<device>/<locale>/ and out/previews/<device>/<locale>/. The iPhone gets 1320 x 2868 screenshots and an 886 x 1920 H.264 preview. Google Play gets 1080 x 1920 screenshots. A preview must run 15 to 30 seconds.

Google Play

The pixel-10-pro device key renders Google Play phone screenshots (1080 x 1920) from the same scenes. The example config already lists this key. Remove it from devices for an iOS-only run. Argent flows also replay on Android, so the scene flows are shared. A flow works on both platforms when its selectors match. The captures come from an Android emulator. Its AVD must use the Pixel 10 Pro or the Pixel 9 Pro hardware profile (both have a 1280 x 2856 screen). goldie reuses a running emulator that matches, or boots the AVD itself. Create the AVD from either device definition (Android Studio > Device Manager). Then add the build to the config:

devices: ["iphone-6.9", "pixel-10-pro"],
android: {
  appPath: "/path/to/app-release.apk",
  applicationId: "com.example.app",
},

goldie frames Android tiles with the bundled Pixel 10 Pro bezel. The frame variant is iPhone art, so it does not apply to them. android.frame swaps in your own art and its geometry. The Play Store promo video is a YouTube link, so preview and all record the preview scene on the emulator and render a portrait video for you to post on YouTube yourself. Apple's 15-30 second window does not apply to it.

Design

https://github.com/user-attachments/assets/d6171a90-8fc1-437b-a574-5a8547068a3c

The studio switches devices, backgrounds, templates, bezel, fonts and per-tile copy. It saves the choices to goldie.design.json, so the CLI renders the same result. The config also takes:

Remarks

Sponsored by Software Mansion

goldie is sponsored by Software Mansion, the software agency that created Argent. You can hire Software Mansion for your next project.

Software Mansion

goldie (software-mansion-labs/goldie)

Searching Database…

2.5K ·GitHub
Goldie
这是什么？Goldie 通过在 iOS 模拟器或 Android 仿真器上回放录制的操作流程，为移动应用生成 App Store 和 Google Play 截图，以及 App Store 预览视频。
它是命令行工具，还是只能配合特定的移动框架使用？它是一个与框架无关的命令行工具：它通过模拟器或仿真器驱动真实应用，因此对 SwiftUI、UIKit、Jetpack Compose、Flutter、React Native 和 Kotlin Multiplatform 应用的处理方式完全相同。
怎么让它在我的应用上跑起来？安装命令行工具并把 goldie 的技能添加到你的编程智能体，然后在应用仓库里直接让智能体生成截图即可；它会询问要面向哪些商店，探索应用，编写流程和配置，并打开 studio 供你审阅。
使用之前需要安装什么？你需要 Node 20+ 和 PATH 中的 ffmpeg。生成 App Store 截图还需要装有 Xcode iOS 模拟器的 macOS，而 Google Play 截图需要 Android 仿真器（可在 macOS、Linux 和 Windows 上运行）。
应用 UI 变了会怎样？如果我忘了用 release 构建呢？应用一有改动，录制的流程就会失效，你得让编程智能体修复它们或用 argent 重新录制；此外，debug 构建会把 LogBox 横幅画进截图中，所以要得到干净的截图必须使用 release 构建。
我能在 Windows 或 Linux（而不只是 macOS）上生成 Google Play 截图吗？可以，Android 仿真器方案在 macOS、Linux 和 Windows 上都能用，不过 iOS 模拟器仅限 macOS，因此在 Linux/Windows 上只能保留 pixel-10-pro 设备配置。
内置了哪些设计模板？studio 内置 editorial、showcase、magazine、storyboard 和 dynamic 等模板，还有 classic、hero、tilt、duo 和 panorama 等单独版式，可以按每个格子自由混搭。
预览视频可以多长？Apple 要求 App Store 预览视频时长为 15 到 30 秒；这条规则不适用于 Google Play 宣传视频，后者只是你自己上传到 YouTube 的渲染好的竖屏视频。
我可以自定义设备边框和字体吗？可以，frame 接受 17-pro-blue、17-pro-silver、17-pro-orange 等预设或自定义边框图片，theme.fontFamily 允许你选择任意 CSS 字体栈，并内置了 Merriweather、DM Mono、Lato、DM Sans、Montserrat 和 Noto Sans SC。
iOS 和 Android 可以共用同一套录制的流程吗？可以，只要流程中的选择器在各平台上都能匹配应用，argent 流程就能在两个平台上回放，因此一个场景可以同时驱动两个商店的截图。
What are similar projects?vicoa, agent-device, vibe-aso, fastlane, NativeScript, mobile-mcp, iPhone-use, dsh-mobile
Which topics is it in?screenshots, kotlin-multiplatform, screenshot, swiftui, flutter, xcode, react-native, ffmpeg, image-processing, mobile-app, video, coding-agent
Creator
software-mansion-labs
Size
18.2 MB
Stars
2.5K
Updated
CommitOct 06
Age
1mo
Commits · 90 Days