Android Store Listing

Create feature graphic and complete store listing metadata for Google Play Store.

Prerequisites

• /devtools:android-fastlane-setup completed
• /devtools:android-app-icon completed (for icon assets)

Inputs

Input	Required	Default	Description
app_name	Yes	-	App name
tagline	Yes	-	Short tagline for feature graphic
primary_color	No	#6200EE	Primary brand color (hex)
description	No	Template	Full app description

Play Store Asset Requirements

Asset	Dimensions	Format	Required
App Icon	512 x 512 px	PNG	Yes
Feature Graphic	1024 x 500 px	PNG/JPEG	Yes
Phone Screenshots	320-3840 px (16:9 or 9:16)	PNG/JPEG	2-8 required
7" Tablet Screenshots	320-3840 px (16:9 or 9:16)	PNG/JPEG	Up to 8
10" Tablet Screenshots	320-3840 px (16:9 or 9:16)	PNG/JPEG	Up to 8
Promo Video	YouTube URL	-	Optional

Process

Step 1: Generate Store Listing Guide

Create docs/STORE_LISTING_GUIDE.md with comprehensive instructions.

Step 2: Feature Graphic Creation Options

The feature graphic (1024 x 500 px) is displayed at the top of your Play Store listing.

Option A: Canva (Easiest)

1. Go to canva.com
2. Create custom design: 1024 x 500 px
3. Search templates for "app feature graphic" or "banner"
4. Customize with app name and colors
5. Download as PNG

Option B: Figma (More Control)

1. Open Figma Community Template
2. Duplicate to your account
3. Customize the feature graphic frame
4. Export as PNG at 1x

Option C: Simple Python Script
Use scripts/generate-feature-graphic.py to create a basic feature graphic:

python3 scripts/generate-feature-graphic.py "App Name" "Tagline" "#6200EE"

This creates a simple text-based graphic. For production, use Canva or Figma for a more polished result.

Step 3: Feature Graphic Best Practices

✅ Do:

• Use high contrast text
• Keep text minimal (3-5 words)
• Show your app's primary screen
• Use your brand colors
• Leave space for Play Store overlay

❌ Don't:

• Include pricing or "free" text
• Use excessive text
• Make it too busy/cluttered
• Use low-resolution images

Step 4: Update Metadata Files

Ensure all metadata files exist in fastlane/metadata/android/en-US/:

title.txt (Max 30 characters)

Your App Name

short_description.txt (Max 80 characters)

Short tagline that highlights main benefit

full_description.txt (Max 4000 characters)

Full description of your app.

Key Features:
• Feature 1 description
• Feature 2 description
• Feature 3 description
• Feature 4 description

Why Choose This App?
Explain what makes your app unique and valuable.

Download now and start [doing something valuable]!

changelogs/default.txt (Max 500 characters)

• New: [Feature name]
• Improved: [Enhancement description]
• Fixed: [Bug fix description]

video.txt (Optional)

https://www.youtube.com/watch?v=YOUR_VIDEO_ID

Step 5: Asset Validation

Run validation checks:

# Check icon dimensions
file fastlane/metadata/android/en-US/images/icon.png
# Expected: PNG image data, 512 x 512

# Check feature graphic dimensions
file fastlane/metadata/android/en-US/images/featureGraphic.png
# Expected: PNG image data, 1024 x 500

# Check screenshot count
ls fastlane/metadata/android/en-US/images/phoneScreenshots/ | wc -l
# Expected: 2-8 files

# Check metadata character limits
wc -c fastlane/metadata/android/en-US/title.txt
# Must be <= 30 characters

wc -c fastlane/metadata/android/en-US/short_description.txt
# Must be <= 80 characters

wc -c fastlane/metadata/android/en-US/full_description.txt
# Must be <= 4000 characters

Multi-Language Support

To add additional languages:

# Create locale directory
mkdir -p fastlane/metadata/android/de-DE/images/phoneScreenshots
mkdir -p fastlane/metadata/android/de-DE/changelogs

# Copy and translate metadata files
cp fastlane/metadata/android/en-US/*.txt fastlane/metadata/android/de-DE/
# Edit files with German translations

# Update Screengrabfile to capture additional locales
# In fastlane/Screengrabfile:
# locales(["en-US", "de-DE"])

# Run screenshot automation for all locales
bundle exec fastlane screenshots

Uploading to Play Store

Once all assets are ready:

# Upload metadata only (no build)
bundle exec fastlane upload_metadata

# Upload screenshots only
bundle exec fastlane upload_screenshots

# Full release (includes everything)
bundle exec fastlane deploy_internal

Verification

MANDATORY: Run these commands:

# Check all metadata files exist
ls -la fastlane/metadata/android/en-US/

# Check images exist
ls -la fastlane/metadata/android/en-US/images/

# Validate feature graphic
file fastlane/metadata/android/en-US/images/featureGraphic.png
# Should be: PNG image data, 1024 x 500

# Test metadata upload (dry run)
# bundle exec fastlane upload_metadata --skip_upload_images

Completion Criteria

• docs/STORE_LISTING_GUIDE.md created with full instructions
• Feature graphic at fastlane/metadata/android/en-US/images/featureGraphic.png
• Feature graphic is 1024x500 PNG
• All metadata files in fastlane/metadata/android/en-US/:
  • title.txt (max 30 chars)
  • short_description.txt (max 80 chars)
  • full_description.txt (max 4000 chars)
  • changelogs/default.txt
  • video.txt (empty is OK)

Outputs

Output	Location	Description
Store listing guide	docs/STORE_LISTING_GUIDE.md	Complete setup instructions
Feature graphic	fastlane/metadata/android/en-US/images/featureGraphic.png	1024x500 banner
Title	fastlane/metadata/android/en-US/title.txt	App title
Short description	fastlane/metadata/android/en-US/short_description.txt	80 char tagline
Full description	fastlane/metadata/android/en-US/full_description.txt	Complete description
Changelogs	fastlane/metadata/android/en-US/changelogs/default.txt	Release notes

Troubleshooting

"Metadata upload fails"

Cause: Character limits exceeded or invalid format
Fix: Validate all text files with wc -c

"Feature graphic rejected"

Cause: Wrong dimensions or contains prohibited content
Fix: Ensure exactly 1024x500, no pricing/ratings/review text

"Screenshots not showing"

Cause: Wrong format or dimensions
Fix: Ensure PNG/JPEG, min 320px, aspect ratio 16:9 or 9:16

Next Steps

After completing this skill:

1. Review all metadata for accuracy and appeal
2. Run /devtools:android-workflow-internal to setup deployment
3. Upload to Play Store: bundle exec fastlane deploy_internal