generate_screenshot
Compose store-ready screenshots by overlaying user app UI with AI-generated backgrounds, clipart, and captions. Writes platform-specific PNGs.
Instructions
Compose one store screenshot from user app UI + YOUR in-session AI assets (background, clipart, titles, alignment). Writes opaque PNGs at store sizes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | ||
| label | No | AI-written small category label above the headline | |
| sizes | No | Size ids from list_export_sizes, e.g. ["ios-6.9"]. Defaults to platform primary. | |
| layout | No | Layout template. Use custom + devicePlacement/captionStyle for fully AI-directed alignment. Vary across slides. | |
| clipart | No | AI-generated decorative images (clipart, icons, stickers, blobs) with positions. Generate in the same session. | |
| gradient | No | Optional CSS gradient under/over AI background; also used when backgroundImage omitted | |
| headline | Yes | AI-written headline. Use \n for line breaks. 3–5 words per line, one idea. | |
| platform | Yes | Target store platform | |
| vignette | No | Soft dark vignette for text contrast (default true when backgroundImage set) | |
| outputDir | Yes | Absolute directory path to write PNG files | |
| deviceFrame | No | Device frame style. Defaults: iphone for ios, android for android. | |
| subheadline | No | AI-written subtitle under the headline | |
| captionStyle | No | AI-chosen title/subtitle alignment and placement | |
| appScreenshot | Yes | Absolute path to the in-app screenshot PNG/JPG (user-provided) | |
| filenamePrefix | No | Filename prefix, e.g. "01-hero" (default: "screenshot") | |
| backgroundColor | No | Solid fallback only if no AI background/gradient | |
| backgroundImage | No | REQUIRED for best quality: absolute path to AI-generated background for this slide (same session). Portrait ~master size. | |
| devicePlacement | No | AI-chosen phone position overrides (use with any layout; required for layout=custom) | |
| appScreenshotSecondary | No | Optional second screenshot for two-phone layout |