Derive background theme suggestions from the app's own colors.

Call this FIRST, before rendering any mockups, with all of the user's screenshots. It extracts the app's dominant background and accent colors and returns a JSON list of themes ({name, bg_color, text_color, frame, why}), ordered by recommendation strength, with text color and frame already chosen for contrast. Present the list to the user with the hex values, recommend the first entry, and always offer a final Custom option where the user supplies their own bg_color, text_color, and frame instead.

Args: screenshots: Absolute paths of the app screenshots to analyze.

Wrap an app screenshot in an iPhone 16 Pro frame with marketing text above it, producing an App Store-ready preview image.

If the user did not dictate the title text, draft one (3-7 words, benefit-led) and get the user's approval or edits before calling this.

Args: screenshot: Absolute path to the source screenshot (any size; it is cover-fitted to the phone screen). title: Headline text rendered above the phone. out: Absolute path for the output PNG. frame: iPhone body color, "black" or "silver". bg_color: Background color as hex (e.g. "#f5f1ea"). Pass two hex colors separated by a comma for a vertical gradient. text_color: Title/subtitle color as hex. subtitle: Optional smaller line under the headline. size: Output dimensions as WxH. App Store accepts 1284x2778, 1242x2688 (portrait) or 2778x1284, 2688x1242 (landscape). bleed: If true, the phone bleeds off the bottom edge instead of fitting fully inside the canvas. add_frame: If False, the screenshot is placed directly on the background without adding a phone frame. Use this when the source image already contains a device frame (e.g. a previous mockup output) to avoid phone-inside-phone.

Create App Store preview mockups for many screenshots in one call.

If the user did not dictate the titles, draft one per screenshot (3-7 words, benefit-led), show the user the full list, and get approval or edits before calling this.

Each job needs a screenshot path and a title; everything else is optional and falls back to the batch-level defaults. Jobs without an explicit out path are written to output_dir as NN_.png, numbered in job order.

Args: jobs: List of jobs, each {screenshot, title, subtitle?, out?, frame?, bg_color?, text_color?}. output_dir: Directory for outputs when a job has no out (default: alongside each screenshot). frame: Default iPhone body color, "black" or "silver". bg_color: Default background hex ("#hex1,#hex2" for a gradient). text_color: Default text color hex. size: Output dimensions as WxH for all jobs. bleed: If true, phones bleed off the bottom edge.