PROTOTYPES LAB - APP STORE PUBLISHING TOOLKIT
Prepared 2026-11-20. Read the accompanying PDF before submitting an app.
Original files in the parent directory have been preserved.

SETUP
Requires macOS, Python 3, ImageMagick 7, FFmpeg and FFprobe.
With Homebrew already installed, install missing tools using:
  brew install imagemagick ffmpeg python
This package does not install tools automatically.

Open Terminal:
  cd "/Users/ovidiucarstea/Desktop/AppStore Distribution/PublishingToolkit"

SCREENSHOTS
  bash resize_app_screenshots.sh INPUT_DIR OUTPUT_DIR WIDTH HEIGHT [fit|fill] [BACKGROUND]

Examples (replace the sample paths):
  bash resize_app_screenshots.sh "$HOME/Desktop/AppScreenshots/iPhone" "$HOME/Desktop/AppAssets/iPhone" 1206 2622 fit white
  bash resize_app_screenshots.sh "$HOME/Desktop/AppScreenshots/iPad" "$HOME/Desktop/AppAssets/iPad" 2064 2752 fit white
  bash resize_app_screenshots.sh "$HOME/Desktop/AppScreenshots/Mac" "$HOME/Desktop/AppAssets/Mac" 2560 1600 fit black

fit preserves all content with padding; fill crops to fill the canvas.
Both preserve aspect ratio. Review cropping before using fill. The script
handles PNG/JPG/JPEG (including uppercase), flattens transparency, and writes
8-bit RGB PNGs. It does not recurse into subfolders or overwrite existing
outputs. Output names retain the input extension (e.g. capture.JPG.png).
Supply captures from the correct platform/device and supported orientation.
Resizing a Mac screenshot does not turn it into an accurate iPhone capture.

MOVIES
Keep make_app_preview.sh beside app_preview.py.
  bash make_app_preview.sh MODE INPUT OUTPUT WIDTH HEIGHT [OPTIONS]

Resize an already 15-30 second iPhone portrait video:
  bash make_app_preview.sh resize "$HOME/Desktop/preview.mp4" "$HOME/Desktop/iphone-preview.mp4" 886 1920

Speed up an entire long Mac movie to 29.8 seconds:
  bash make_app_preview.sh speed "$HOME/Desktop/long-demo.mp4" "$HOME/Desktop/mac-preview.mp4" 1920 1080 --seconds 29.8

Take a 20-second excerpt starting at 45 seconds, preserving normal speed:
  bash make_app_preview.sh trim "$HOME/Desktop/long-demo.mp4" "$HOME/Desktop/excerpt.mp4" 1920 1080 --seconds 20 --start 45

Append --mute to replace audio with silence. Silent sources receive a silent
stereo AAC track. Audio tempo is changed with video speed; very high speed
can make narration unusable, so edit the demo or use --mute.

The script outputs H.264 High/4.0, yuv420p, 30 fps, target 10 Mbps / max
12 Mbps, AAC stereo 256 kbps at 48 kHz, with aspect-preserving padding.
Actual average video/audio bitrate may be lower on simple/silent material.
SDR masters only; HDR is rejected when identified. No source is modified.
It validates dimensions, codecs, frame rate, duration and 500 MB size cap.
Use 29.8 seconds for margin under the 30-second limit. Speed mode changes
the whole timeline; trim mode discards material. Neither guarantees review
acceptance. Watch and listen to the final file before upload.

PRIVACY POLICY
The HTML in THIS folder is an unfinished reusable template. The original
NATO Spell HTML in the parent directory is unchanged.
1. Copy privacy-policy.example.json to MyApp-privacy.json.
2. Replace EVERY placeholder with verified details about the shipped app.
3. Run:
   python3 generate_privacy_policy.py MyApp-privacy.json MyApp_privacy_policy.html
4. Read the generated HTML, verify claims against code/SDK/network behavior,
   then publish it at a public HTTPS URL and link it in the app and App Store
   Connect. A prototypeslab.local URL is not publicly accessible to review.
The generator refuses missing placeholders and overwrites. It validates
structure, not the truth of the supplied facts or legal sufficiency.

REUSABLE WRITING PROMPT
Prepare an application-specific privacy policy using the reusable template
and the facts in [APP FACTS FILE]. Inspect [APP SOURCE FOLDER] and dependency
manifests when available. Cover on-device data, network requests, SDKs,
analytics, diagnostics, accounts, purchases, cloud/backups, permissions,
support messages, recipients, retention/deletion, security, children,
privacy rights and contact details. Distinguish local processing from
off-device collection. Do not infer "no data collected" from offline UI or
database encryption. Do not invent a contact address or unsupported privacy
promise. List missing facts for me to resolve; keep output marked draft
until resolved. Generate a new [APP_NAME]_privacy_policy.html without
overwriting any existing policy. Supply matching App Privacy label guidance
and identify any differences from the app's actual SDK/network behavior.

ENCRYPTION
Encryption_Answers.txt contains two conditional descriptions and guidance
for App Store Connect. It is not a preapproved classification. Replace
bracketed app/version fields and verify the optional sentences before use.

ASSET NOTES
App Store Connect previews require actual uploaded movies. A YouTube URL
cannot replace that file. Your blog can separately embed its YouTube demo.
Mac screenshots use 16:10; Mac previews use 1920x1080 (16:9).
The old resize_iphone_screenshots_1280x800.sh actually targets a Mac size.
The old -t 30 command trims; it does not speed up the entire source.

See the PDF's dated Apple references for accepted sizes and current rules.
