Skip to main content

Screenshot Generation

Generate marketing screenshots from a text description using OpenAI (prompt generation) and fal.ai (image generation).

Looking for screenshot translation to other locales? That moved to the ASO section — see Screenshot Translation.

generate-screenshots

kappmaker generate-screenshots --prompt "A fitness tracking app with workout plans"
kappmaker generate-screenshots --prompt "A meditation app" --input ./my-screenshots
kappmaker generate-screenshots --prompt "A recipe app" --style 3 --resolution 4K

Flow

  1. OpenAI (GPT-4.1) generates a detailed screenshot specification from your description.
  2. fal.ai generates a grid of 8 screenshots (nano-banana-2, or nano-banana-2/edit with reference images).
  3. The grid is split into individual screenshots.

Output

Assets/screenshots/appstore/ + Assets/screenshots/playstore/ (+ Fastlane dirs if MobileApp/distribution exists).

Options

FlagDescriptionDefault
--prompt <text>App description (required)
--input <dir>Reference screenshot directoryAuto-detect Assets/screenshots
--style <id>Style preset (1-8)1
--output <dir>Output base directoryAssets/screenshots
--resolution <res>AI resolution (1K, 2K, 4K)2K

Screenshot Styles

StyleDescription
1Rich multi-device marketing (bold text, shadows & reflections)
2Minimal Apple-style (single centered device, clean whitespace)
3SaaS conversion-focused (feature bullet callouts)
4Bold geometric color blocks (vibrant split backgrounds)
5Full-bleed UI, no device frames (edge-to-edge with blur overlay)
6Cinematic depth (layered devices, depth-of-field)
7Editorial lifestyle (soft neutral backgrounds, serif type)
8Floating product reveal (Apple keynote aesthetic)

Requirements

Requires falApiKey, openaiApiKey, and imgbbApiKey (if using reference images).

Next: translate and localize

Once you have generated screenshots, run Screenshot Translation to fan them out to 48+ locales, and Metadata Localization to write the matching text metadata.