AppStore Prep

Automated App Store asset generation for Vue/Capacitor and React Native apps.

Uses AI (GPT-4o-mini for text, DALL-E 3 for images) to generate all assets needed for TestFlight and App Store submission based on your app's documentation.

Features

• Project Auto-Detection: Automatically detects Vue/Capacitor, React Native, and Expo projects
• Documentation Mining: Extracts information from README, CLAUDE.md, REQUIREMENTS.md, etc.
• Feature Detection: Identifies app features from dependencies (camera, GPS, push notifications, etc.)
• Text Generation: Creates optimized App Store descriptions, keywords, and release notes
• Screenshot Generation: Creates professional marketing screenshots using DALL-E 3
• Icon Generation: Generates app icons in all required sizes
• Fastlane Compatible: Outputs in fastlane metadata format for automation

Installation

cd ~/dev2/AppStorePrep
npm install

Configuration

Create a .env file with your OpenAI API key:

cp .env.example .env
# Edit .env and add your API key

Usage

# Basic usage - generate all assets
node src/index.js /path/to/your/app

# Specify output directory
node src/index.js /path/to/your/app -o ./my-assets

# Skip screenshot generation (faster, text only)
node src/index.js /path/to/your/app --skip-screenshots

# Skip icon generation
node src/index.js /path/to/your/app --skip-icon

# Dry run - analyze only, don't generate
node src/index.js /path/to/your/app --dry-run

# Specify locale
node src/index.js /path/to/your/app --locale es-ES

Examples

FireProof Inspector (Vue/Capacitor)

node src/index.js ~/dev2/fireproof/frontend/fire-extinguisher-web

U-Rent (React Native/Expo)

node src/index.js ~/dev2/clients/U-Rent/u-rent-platform/apps/mobile

Output Structure

appstore-assets/
├── metadata/
│   ├── metadata.json       # All text content as JSON
│   ├── name.txt            # App name (30 chars)
│   ├── subtitle.txt        # Subtitle (30 chars)
│   ├── description.txt     # Full description (4000 chars)
│   ├── keywords.txt        # Keywords (100 chars)
│   ├── whats-new.txt       # Release notes
│   ├── promotional-text.txt # Promo tagline (170 chars)
│   ├── privacy-summary.txt  # Privacy policy summary
│   └── category.txt        # Suggested category
├── screenshots/
│   ├── screenshot_1_hero.png
│   ├── screenshot_2_feature.png
│   ├── ...
│   └── screenshots.json    # Screenshot metadata
├── icons/
│   ├── AppIcon-1024.png    # App Store icon
│   ├── AppIcon-180.png     # iPhone @3x
│   ├── ...
│   └── icons.json          # Icon metadata
├── fastlane/
│   └── metadata/
│       └── en-US/          # Fastlane-compatible structure
│           ├── name.txt
│           ├── description.txt
│           └── ...
└── UPLOAD_GUIDE.md         # Step-by-step upload instructions

Supported Project Types

Type	Detection
Vue + Capacitor	@capacitor/core + vue in dependencies
React + Capacitor	@capacitor/core + react in dependencies
React Native	react-native in dependencies
Expo	expo in dependencies

Detected Features

The tool automatically detects these features from your dependencies:

• Camera (@capacitor/camera, react-native-camera, expo-camera)
• Location (@capacitor/geolocation, expo-location)
• Push Notifications (@capacitor/push-notifications, expo-notifications)
• Barcode Scanning (@capacitor-mlkit/barcode-scanning, expo-barcode-scanner)
• Biometrics (expo-local-authentication, react-native-biometrics)
• Offline Support (realm, watermelondb, @capacitor/filesystem)
• Maps (react-native-maps, expo-maps)
• Payments (@stripe/stripe-react-native)
• And more...

Text Generation

Uses GPT-4o-mini via OpenAI API to generate:

• Description: Compelling, benefit-focused app description optimized for conversion
• Keywords: ASO-optimized search keywords (100 char limit)
• Subtitle: Punchy tagline (30 char limit)
• What's New: User-friendly release notes
• Promotional Text: Marketing hook (170 char limit)
• Privacy Summary: Clear data usage explanation

Screenshot Generation

Uses DALL-E 3 to generate professional marketing screenshots:

• Realistic iPhone device frames
• Marketing headlines and subtitles
• Brand-consistent color schemes
• Feature-specific scenes
• App Store quality (1024x1792 portrait)

Icon Generation

Uses DALL-E 3 for base icon, then sharp for resizing:

• All required iOS icon sizes (1024, 180, 167, 152, 120, etc.)
• Automatic symbol detection based on app purpose
• Brand color extraction
• Modern iOS design language

API Costs

Approximate costs per run (with all features):

Component	API	Approx. Cost
Text Generation	GPT-4o-mini	~$0.02
Screenshots (5)	DALL-E 3 HD	~$0.60
App Icon	DALL-E 3 HD	~$0.12
Total		~$0.75

Use --skip-screenshots and --skip-icon to reduce costs.

License

MIT

Author

ServiceVision - https://servicevision.net