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
What is this?Goldie generates App Store and Google Play screenshots, plus App Store preview videos, for a mobile app by replaying recorded flows on an iOS simulator or Android emulator.
Is this a CLI tool, or does it only work with a specific mobile framework?It is a framework-agnostic CLI: it drives the real app through a simulator or emulator, so it works the same way for SwiftUI, UIKit, Jetpack Compose, Flutter, React Native and Kotlin Multiplatform apps.
How do I get it running on my app?Install the CLI and add goldie's skill to your coding agent, then from your app repo just ask the agent to make screenshots; it asks which stores to target, explores the app, writes the flows and config, and opens the studio for review.
What do I need installed before I can use it?You need Node 20+ and ffmpeg on the PATH. App Store screenshots additionally require macOS with Xcode's iOS simulators, while Google Play screenshots need an Android emulator (which works on macOS, Linux and Windows).
What happens when the app's UI changes, or if I forget to use a release build?Recorded flows fail once the app changes, so you have to ask the coding agent to repair them or re-record with argent; also, debug builds paint LogBox banners into the captures, so a release build is required for clean screenshots.
Can I generate Google Play screenshots on Windows or Linux, not just macOS?Yes, the Android emulator path works on macOS, Linux and Windows, though on Linux/Windows you can only keep the pixel-10-pro device configured since iOS simulators are macOS-only.
What design templates are built in?The studio ships with templates like editorial, showcase, magazine, storyboard and dynamic, plus individual layouts such as classic, hero, tilt, duo and panorama that you can mix per tile.
How long can a preview video be?Apple requires App Store preview videos to run 15 to 30 seconds; that rule does not apply to the Google Play promo video, which is just rendered portrait footage you post to YouTube yourself.
Can I customize the device bezel and fonts?Yes, frame accepts presets like 17-pro-blue, 17-pro-silver, 17-pro-orange or a custom bezel image, and theme.fontFamily lets you pick any CSS font stack, with Merriweather, DM Mono, Lato, DM Sans, Montserrat and Noto Sans SC bundled.
Do iOS and Android share the same recorded flows?Yes, argent flows replay on both platforms as long as a flow's selectors match the app on each platform, so one scene can drive screenshots for both stores.
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