Skip to content
Back to search

goldie

MarketplaceWorks with Claude CodeGitHub

✨ agentic app store previews and screenshots

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/software-mansion-labs-goldie/badge.svg)](/listings/software-mansion-labs-goldie)

HTML

<a href="/listings/software-mansion-labs-goldie"><img src="/api/listings/software-mansion-labs-goldie/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://github.com/software-mansion/argent#linux-host-extra-prerequisites-for-android-emulators) 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "goldie",
  3. "owner": { "name": "Kacper Kapuściak" },
  4. "plugins": [
  5. {
  6. "name": "goldie",
  7. "source": "./",
  8. "description": "App Store and Play Store screenshots and app preview videos for an iOS or Android app, driven by argent flows on a simulator or emulator.",
  9. "category": "productivity"
  10. }
  11. ]
  12. }
README.md · README · 153 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Goldie: App Store screenshot generator for coding agents (and humans)
  2. goldie makes App Store and Google Play screenshots, and App Store preview
  3. videos, for a mobile app.
  4. [argent](https://github.com/software-mansion/argent) replays flows on an iOS
  5. simulator or an Android emulator. goldie frames the captures with a device
  6. bezel, a background and a headline. It joins the clips into a preview video.
  7. It checks the result against the upload rules of the stores.
  8. goldie is framework agnostic. It drives the app through the simulator or the
  9. emulator. It works the same for SwiftUI, UIKit, Jetpack Compose, Flutter,
  10. React Native and Kotlin Multiplatform apps.
  11. ## Install
  12. You need Node 20 or newer and ffmpeg on the PATH. App Store screenshots need
  13. macOS with iOS simulators (Xcode). Google Play screenshots need an Android
  14. emulator, which works on macOS, Linux and Windows. On Linux, argent needs
  15. [a few extra packages](https://github.com/software-mansion/argent#linux-host-extra-prerequisites-for-android-emulators)
  16. for Android emulators. On a Linux or Windows machine keep only `pixel-10-pro`
  17. in `devices`; `goldie doctor` says so when an iOS device is configured on a
  18. host that cannot run it.
  19. Install the CLI:
  20. ```
  21. npm i -g goldie
  22. ```
  23. Add the skill to your coding agent:
  24. ```
  25. npx skills add kacperkapusciak/goldie # Cursor, Codex, any agent
  26. /plugin marketplace add kacperkapusciak/goldie # Claude Code
  27. /plugin install goldie@goldie
  28. ```
  29. The skill works with all agents that support the skills format.
  30. ## Use with a coding agent
  31. Ask from your app repo:
  32. ```
  33. create app store screenshots using goldie
  34. ```
  35. The agent asks which stores to target. It explores the app, writes the flows
  36. and the config, and opens the studio. Follow-ups such as `use a dark
  37. background` edit the same files.
  38. ## Use by hand
  39. Copy `goldie.config.example.ts` to `goldie.config.ts`. Point its scenes at
  40. argent flows in `.argent/flows`. Then run:
  41. ```
  42. goldie doctor Check tools, simulators and flows
  43. goldie all Capture, frame, render the preview and verify
  44. goldie studio Preview and tweak the assets in the browser
  45. ```
  46. The output goes to `out/screenshots/<device>/<locale>/` and
  47. `out/previews/<device>/<locale>/`. The iPhone gets 1320 x 2868 screenshots
  48. and an 886 x 1920 H.264 preview. Google Play gets 1080 x 1920 screenshots.
  49. A preview must run 15 to 30 seconds. Add `"ipad-13"` to `devices` for
  50. 13" iPad screenshots (2064 x 2752) and a 1200 x 1600 preview from the same
  51. flows, each device with its own bezels, captures and output folder.
  52. Every locale renders from one capture run in the first locale, which suits
  53. apps whose screens look the same in every language. Set
  54. `localizedCaptures: true` to capture each locale in its own language instead:
  55. `capture` replays the flows once per locale with the simulator pinned to it,
  56. into `out/raw/<device>/<locale>/`, and each locale's screenshots, preview and
  57. studio view use its own captures. It applies to iOS devices; Android emulators
  58. keep one shared capture.
  59. ## Google Play
  60. The `pixel-10-pro` device key renders Google Play phone screenshots
  61. (1080 x 1920) from the same scenes. The example config already lists this
  62. key. Remove it from `devices` for an iOS-only run. Argent flows also replay
  63. on Android, so the scene flows are shared. A flow works on both platforms
  64. when its selectors match. The captures come from an Android emulator. Its
  65. AVD must use the Pixel 10 Pro or the Pixel 9 Pro hardware profile (both have
  66. a 1280 x 2856 screen). goldie reuses a running emulator that matches, or
  67. boots the AVD itself. Create the AVD from either device definition
  68. (Android Studio > Device Manager). Then add the build to the config:
  69. ```ts
  70. devices: ["iphone-6.9", "pixel-10-pro"],
  71. android: {
  72. appPath: "/path/to/app-release.apk",
  73. applicationId: "com.example.app",
  74. },
  75. ```
  76. goldie frames Android tiles with the bundled Pixel 10 Pro bezel. The `frame`
  77. variant is iPhone art, so it does not apply to them. `android.frame` swaps
  78. in your own art and its geometry. The Play Store promo video is a YouTube
  79. link, so `preview` and `all` record the preview scene on the emulator and
  80. render a portrait video for you to post on YouTube yourself. Apple's 15-30
  81. second window does not apply to it.
  82. ## Design
  83. https://github.com/user-attachments/assets/d6171a90-8fc1-437b-a574-5a8547068a3c
  84. The studio switches devices, backgrounds, templates, bezel, fonts and
  85. per-tile copy. It saves the choices to `goldie.design.json`, so the CLI
  86. renders the same result. The config also takes:
  87. - `frame`: `17-pro-blue`, `17-pro-silver`, `17-pro-orange` for the iPhone,
  88. `ipad-pro-13-silver`, `ipad-pro-13-space-gray` for the iPad (one variant,
  89. or one per device key), or a custom bezel image; `theme.screenOnly: true`
  90. removes it.
  91. - `theme.template`: `editorial`, `showcase`, `magazine`, `storyboard`,
  92. `dynamic`, or your own layout sequence from `classic`, `copy-below`, `hero`,
  93. `offset`, `tilt`, `tilt-right`, `duo`, `duo-tilt`, `panorama`,
  94. `panorama-duo`, `minimal`.
  95. - `theme.fontFamily`: a CSS font stack. Merriweather, DM Mono, Lato, DM Sans,
  96. Montserrat, Noto Sans SC (Simplified Chinese) and Noto Sans Arabic are
  97. bundled; the two Noto faces are also appended to every stack as a per-glyph
  98. fallback, so Chinese and Arabic copy draws whatever font you name.
  99. - `theme.fontFiles`: typefaces of your own, registered alongside the bundled
  100. ones so `fontFamily` can name them. Needed for a brand font, and for any
  101. script the bundled families do not cover - the copy is drawn with skia, not a
  102. browser, so an unregistered family exports as tofu boxes rather than falling
  103. back. Paths are relative to the config.
  104. ```ts
  105. fontFiles: [
  106. { family: "Zain", files: { 400: "../assets/fonts/Zain-Regular.ttf",
  107. 700: "../assets/fonts/Zain-Bold.ttf" } },
  108. ],
  109. fontFamily: "Zain",
  110. ```
  111. - `decorations`: badges or images layered behind the device.
  112. ## Remarks
  113. - Use a Release build. Debug builds paint LogBox banners into the captures.
  114. - Flows fail when the app changes. Ask the coding agent to repair them, or
  115. re-record them with argent.
  116. ## Sponsored by Software Mansion
  117. goldie is sponsored by [Software Mansion](https://swmansion.com), the
  118. software agency that created [Argent](https://github.com/software-mansion/argent).
  119. You can [hire Software Mansion](https://swmansion.com/contact) for your next project.
  120. <a href="https://swmansion.com"><img src="assets/software-mansion-logo-positive-s-left-top@1x.png" alt="Software Mansion" width="200" /></a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.