Apple App Store Agent

Automate preparation of all assets required for Apple App Store submission: metadata, screenshots, icons, and fastlane configuration.

Workflow Decision Tree

User Request
    │
    ├─► "Full App Store preparation" ──► Run complete workflow (all steps)
    │
    ├─► "Generate metadata" ──► Step 1: Gather app info → Generate descriptions, keywords
    │
    ├─► "Create screenshots" ──► Step 2: Get app screens → Generate styled screenshots  
    │
    ├─► "Make app icon" ──► Step 3: Get concept → Generate icon in all sizes
    │
    ├─► "Set up fastlane" ──► Step 4: Create folder structure with all metadata files
    │
    └─► "Prepare review info" ──► Step 5: Generate review notes, demo credentials template

Step 1: Generate App Metadata

Gather information from user about their app:

App name and bundle identifier
Core functionality (what problem it solves)
Target audience
Key features (3-5 main features)
Competitor apps (for positioning)

Output Files

Generate these localized text files (start with en-US):

File	Max Length	Purpose
`name.txt`	30 chars	App name on App Store
`subtitle.txt`	30 chars	Brief tagline below app name
`description.txt`	4000 chars	Full app description
`promotional_text.txt`	170 chars	Updatable promo text (top of description)
`keywords.txt`	100 chars	Comma-separated, no spaces after commas
`release_notes.txt`	4000 chars	What's new in this version
`support_url.txt`	URL	Support page link
`marketing_url.txt`	URL	Marketing page link
`privacy_url.txt`	URL	Privacy policy link (REQUIRED)

Writing Guidelines

Description structure:

Opening hook (1-2 sentences) - immediately convey value
Key features with bullet points (use ● not -)
Social proof if available
Call to action

Keywords strategy:

Use all 100 characters
No duplicates of words in app name
Include common misspellings
Mix head terms and long-tail
Separate with commas, no spaces

Step 2: Create App Screenshots

Required Dimensions (2024/2025)

iPhone (Required: ONE of these):

6.9" display: 1320 x 2868 px (portrait) / 2868 x 1320 px (landscape) - iPhone 16 Pro Max
6.5" display: 1242 x 2688 px (portrait) / 2688 x 1242 px (landscape) - fallback

iPad (Required if app runs on iPad):

13" display: 2064 x 2752 px (portrait) / 2752 x 2064 px (landscape)

Optional (auto-scaled from above):

All other iPhone sizes scale from 6.9"/6.5"
All other iPad sizes scale from 13"

Screenshot Design Process

Identify key screens - Focus on 5-10 most compelling features
Create device mockups - Use scripts/generate_screenshot_mockup.py
Add marketing text - Short, benefit-focused headlines
Maintain consistency - Same style, colors, typography across all

Screenshot Content Guidelines

First 3 screenshots are critical (visible in search results)
Show actual app UI (Apple rejects misleading screenshots)
Text overlays: 6-8 words max per screenshot
Include device frame for professional look
Use app's brand colors for backgrounds

See references/screenshot-specs.md for detailed dimensions and file naming.

Step 3: Generate App Icon

Icon Specifications

App Store icon: 1024 x 1024 px (PNG, no transparency, no rounded corners)

Apple applies corner radius automatically. Submit square icon.

Icon Design Principles

Simple, recognizable silhouette
Limited color palette (2-3 colors)
No text (illegible at small sizes)
Avoid photos (don't scale well)
Test at 29x29 px for clarity

Use scripts/generate_app_icon.py to create icon or provide concept for AI generation.

Step 4: Set Up Fastlane Structure

Create this folder structure for fastlane deliver:

fastlane/
├── Appfile
├── Deliverfile
├── metadata/
│   ├── copyright.txt
│   ├── primary_category.txt
│   ├── secondary_category.txt
│   ├── en-US/
│   │   ├── name.txt
│   │   ├── subtitle.txt
│   │   ├── description.txt
│   │   ├── keywords.txt
│   │   ├── promotional_text.txt
│   │   ├── release_notes.txt
│   │   ├── privacy_url.txt
│   │   ├── support_url.txt
│   │   └── marketing_url.txt
│   └── review_information/
│       ├── demo_password.txt
│       ├── demo_user.txt
│       ├── email_address.txt
│       ├── first_name.txt
│       ├── last_name.txt
│       ├── notes.txt
│       └── phone_number.txt
└── screenshots/
    └── en-US/
        ├── iphone_6.9_inch/
        │   ├── 1_feature_one.png
        │   ├── 2_feature_two.png
        │   └── ...
        └── ipad_13_inch/
            ├── 1_feature_one.png
            └── ...

Use scripts/init_fastlane_structure.py to generate this structure.

Step 5: App Review Preparation

Review Information Checklist

Demo account credentials (if login required)
Notes explaining non-obvious features
Contact information for reviewer questions
Any required hardware/conditions explained

Common Rejection Reasons to Address

Incomplete metadata - Fill ALL required fields
Placeholder content - Remove "lorem ipsum" or test data
Broken links - Test privacy_url and support_url
Login issues - Demo account must work
Misleading screenshots - Must show actual app

Privacy Policy Requirements

Privacy URL is mandatory. Must include:

What data is collected
How data is used
Third-party sharing
Data retention policy
Contact information

Provide GitHub Pages URL or hosted policy link.

App Categories

Primary category is required. See references/app-categories.md for full list.

Common categories:

Games (with subcategory)
Business
Education
Entertainment
Finance
Health & Fitness
Lifestyle
Productivity
Social Networking
Utilities

Scripts

Script	Purpose
`init_fastlane_structure.py`	Create complete fastlane folder structure
`generate_screenshot_mockup.py`	Add device frames and text to screenshots
`generate_app_icon.py`	Create app icon in required size
`validate_metadata.py`	Check character limits and required fields

Quick Start

For full preparation, run:

python scripts/init_fastlane_structure.py --app-name "My App" --bundle-id "com.company.app"

Then populate the generated text files with content.

apple-app-store-agent