asc-app-shots: App Store Screenshot Designer

Three workflows:

Workflow A — Single Template

Browse templates, apply to a screenshot, optionally enhance with Gemini AI.

Step 1 — Browse and apply

asc app-shots templates list --output table
asc app-shots templates get --id top-hero --preview > preview.html && open preview.html

# Apply to screenshot → HTML preview
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview html > composed.html && open composed.html

# Apply to screenshot → PNG export
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output marketing.png

Step 2 — Enhance with Gemini AI (optional)

asc app-shots generate --file marketing.png
asc app-shots generate --file marketing.png --device-type APP_IPHONE_67
asc app-shots generate --file marketing.png --style-reference inspiration.png
asc app-shots generate --file marketing.png --prompt "warmer colors, deeper shadows"

Workflow B — Gallery Templates

Coordinated multi-screen sets (hero + feature screens).

# Browse gallery templates
asc app-shots gallery-templates list --output table

# Preview all screens in horizontal strip
asc app-shots gallery-templates get --id neon-pop --preview > gallery.html && open gallery.html

# Get gallery details (JSON with shots, template, palette)
asc app-shots gallery-templates get --id neon-pop --pretty

Gallery templates include sample content (headlines, badges, trust marks) ready to customize.

Workflow C — Themed Screenshots

Apply visual themes on top of templates. Two-step flow: generate ThemeDesign once (1 AI call), then apply deterministically to any number of screenshots.

Step 1 — Browse themes

asc app-shots themes list --output table
# → Cartoon, Joyful, Holiday, Zen, Neon, Nature, Retro, Space, Luxury

asc app-shots themes get --id luxury --pretty
asc app-shots themes get --id luxury --context   # AI prompt string

Step 2 — Generate ThemeDesign (1 AI call, reusable)

asc app-shots themes design --id luxury > design.json

Returns JSON with palette (background + textColor) and decorations (floating elements with animations).

Step 3 — Apply ThemeDesign (deterministic, no AI)

# HTML preview
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview html > themed.html

# PNG export
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output themed.png

Alternative: Full AI restyle (fallback)

asc app-shots themes apply \
  --theme luxury --template top-hero \
  --screenshot screen.png --headline "Ship Faster"

Per-slide AI restyle — slower but more creative. Falls back to this when design isn't available.

Command Reference

See [references/commands.md](references/commands.md) for full flag tables.

Templates

asc app-shots templates list [--size portrait] [--preview] [--output table]
asc app-shots templates get --id <ID> [--preview]
asc app-shots templates apply --id <ID> --screenshot <FILE> --headline <TEXT> [--preview html|image]

Gallery Templates

asc app-shots gallery-templates list [--output table]
asc app-shots gallery-templates get --id <ID> [--preview]

Themes

asc app-shots themes list [--output table]
asc app-shots themes get --id <ID> [--context]
asc app-shots themes design --id <ID>
asc app-shots themes apply-design --design <FILE> --template <ID> --screenshot <FILE> --headline <TEXT>
asc app-shots themes apply --theme <ID> --template <ID> --screenshot <FILE> --headline <TEXT>

Generate (Gemini AI)

asc app-shots generate --file <FILE> [--device-type <TYPE>] [--style-reference <FILE>] [--prompt <TEXT>]

Export & Config

asc app-shots export --html <FILE> --output <PNG>
asc app-shots config --gemini-api-key <KEY>

Available Templates

Available Themes

Gemini API Key

Resolution order:

1. --gemini-api-key flag
2. $GEMINIAPIKEY environment variable
3. ~/.asc/app-shots-config.json (via asc app-shots config)

Device Sizes