screenforge

📱 ScreenForge

App Store Asset Generator CLI — icons, splash screens, device frames, ASO metadata from your terminal.

Generate all required app store assets with a single command. One icon → 47+ sizes. One screenshot → device-framed mockup. One description → AI-optimized metadata in any language.

Install

npm install -g screenforge

Commands

📐 Icon Generation

Generate all icon sizes from a single 1024×1024 source image:

# All platforms (iOS + Android + Web + Favicon)
screenforge icon app-icon.png

# Specific platform
screenforge icon app-icon.png --platform ios
screenforge icon app-icon.png --platform android

# Custom output directory
screenforge icon app-icon.png --output ./assets/icons

# WebP format
screenforge icon app-icon.png --format webp

🌅 Splash Screens

Generate splash screens for all device sizes:

# All platforms
screenforge splash logo.png

# iOS only with custom background
screenforge splash logo.png --platform ios --background "#1a1a2e"

# Custom padding
screenforge splash logo.png --padding 30

📱 Device Frames

Add device mockup frames around screenshots:

# Default (iPhone 15 Pro)
screenforge frame screenshot.png

# Specific device
screenforge frame screenshot.png --device pixel-8
screenforge frame screenshot.png --device galaxy-s24

# List available devices
screenforge frame --list

# Custom output
screenforge frame screenshot.png --output framed.png

Available devices: iphone-15-pro, iphone-15, iphone-se, ipad-pro-12, pixel-8, galaxy-s24

🤖 ASO Metadata Generation

AI-powered App Store Optimization metadata:

# Generate metadata
screenforge meta generate -n "MyApp" -d "A productivity app for teams"

# With category and output file
screenforge meta generate -n "MyApp" -d "Task management" -c "Productivity" -o metadata.json

# Translate to other languages
screenforge meta translate -i metadata.json -l es
screenforge meta translate -i metadata.json -l ja
screenforge meta translate -i metadata.json -l fr

Example output:

📱 Title:       MyApp — Smart Team Productivity
📝 Subtitle:    Collaborate Better, Ship Faster
📖 Description: Transform your team's workflow with MyApp...
🔑 Keywords:    productivity, teams, tasks, collaboration, project, management
📋 Short Desc:  Smart productivity tool for modern teams
🎯 Promo Text:  Boost your team's productivity by 10x with AI-powered task management

✍️ Text Overlay

Add marketing text on screenshots:

# Add text at top
screenforge text screenshot.png "Your app, reimagined"

# Custom position and styling
screenforge text screenshot.png "Download Now" --position bottom --color "#ff6b6b" --font-size 48

# Custom font and stroke
screenforge text screenshot.png "Premium Features" --font "Helvetica" --stroke "#000000"

📦 Batch Processing

Process multiple assets from a YAML config:

screenforge batch assets.yml
screenforge batch assets.yml --dry-run

Example assets.yml:

icon:
  input: ./src/icon-1024.png
  platforms: [ios, android]
  output: ./output/icons

splash:
  input: ./src/logo.png
  platforms: [ios, android]
  background: "#1a1a2e"
  output: ./output/splashes

frame:
  inputs:
    - ./screenshots/home.png
    - ./screenshots/profile.png
  device: iphone-15-pro
  output: ./output/frames

meta:
  appName: MyApp
  appDescription: A productivity app for modern teams
  category: Productivity
  locales: [en, es, ja, ko]

text:
  - input: ./screenshots/home.png
    text: "Smart Productivity"
    position: top
    color: "#ffffff"
    fontSize: 72

⚙️ Configuration

# Set AI provider (gemini or openai)
screenforge config set aiProvider gemini

# Set API key
screenforge config set apiKey your-api-key-here

# Set defaults
screenforge config set defaultOutput ./output
screenforge config set defaultPlatform ios

# View current config
screenforge config list

Icon Sizes Reference

Platform	Sizes (px)
iOS	1024, 180, 167, 152, 120, 87, 80, 76, 60, 58, 40, 29, 20
Android	512, 432, 324, 216, 162, 108
Web/PWA	512, 384, 256, 192, 180, 152, 144, 128, 96, 72, 64, 48, 32, 16
Favicon	48, 32, 16

Total: 47 icon sizes from a single source image.

Splash Screen Sizes

Platform	Device	Resolution
iOS	iPhone 15 Pro Max	1290×2796
iOS	iPhone 15 Pro	1179×2556
iOS	iPhone 15	1170×2532
iOS	iPhone SE	750×1334
iOS	iPad Pro 12.9"	2048×2732
iOS	iPad Pro 11"	1668×2388
iOS	iPad Air	1640×2360
iOS	iPad mini	1488×2266
Android	xxxhdpi	1440×3120
Android	xxhdpi	1080×2340
Android	xhdpi	720×1560
Android	hdpi	540×1170
Android	mdpi	360×780

Requirements

• Node.js 20+
• For AI features: Gemini or OpenAI API key

License

MIT © magicpro97