Skip to content

feat: screenshot_matrix.py — multi-device App Store assets #67

Description

@conorluddy

Problem

Generating App Store screenshots across 4-6 devices × light/dark themes × 3-5 screens is multiple days of manual work per submission. This is where the skill's "drive the app" capabilities pay off most.

Sketch

python scripts/screenshot_matrix.py \
  --devices "iPhone SE,iPhone 15 Pro Max,iPad Pro (13-inch)" \
  --screens nav-script.json \
  --themes light,dark \
  --out ./AppStoreAssets/

Boots each device, drives a declarative nav script (tap → wait → screenshot), captures App Store Connect-sized PNGs per theme.

Reuses

  • simctl_boot.py for device boot
  • appearance.py (A2) for theme switching — depends on A2
  • navigator.py for nav script execution
  • screenshot_utils for sizing + naming
  • common/cache_utils.ProgressiveCache for outputs

Open questions

  • Required App Store sizes per Apple's submission matrix (need lookup table baked in).
  • Nav script format: declarative JSON or programmable Python? Recommend JSON for portability.

Definition of done

  • Multi-device boot/teardown working
  • JSON nav script schema documented
  • Output folder structure matches App Store Connect upload expectations
  • SKILL.md updated

Part of the v2.0 coverage expansion epic.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Core features, ship after P1ai-shippableDelegatable to AI agents — clarity:4+ and risk:2 or lowerblast:2Single domain — 2-5 files within one feature folderclarity:3Direction known, details TBD — can start with questionsenhancementNew feature or requestrisk:2Small surface area, existing patterns, minor regression chancesize:MModerate scope, some design neededtype:featureNew functionality or capability

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions