App Icons

📱 Overview

App icons must be square and provided in multiple sizes for different screen densities.

🎯 Android Icons

Replace files in android/app/src/main/res/:

• mipmap-hdpi/ic_launcher.png (72x72px)
• mipmap-mdpi/ic_launcher.png (48x48px)
• mipmap-xhdpi/ic_launcher.png (96x96px)
• mipmap-xxhdpi/ic_launcher.png (144x144px)
• mipmap-xxxhdpi/ic_launcher.png (192x192px)

Tools:

• Use Android Asset Studio
• Upload 512x512px icon, download generated assets
• Or manually create each size from 1024x1024px source

🍎 iOS Icons

Replace icons in ios/[ProjectName]/Images.xcassets/AppIcon.appiconset/:

Key files:

• Icon-App-20x20@2x.png (40px) - iPhone
• Icon-App-29x29@2x.png (58px) - iPhone
• Icon-App-40x40@2x.png (80px) - iPhone
• Icon-App-60x60@3x.png (180px) - iPhone
• Icon-App-76x76@1x.png (76px) - iPad
• Icon-App-83.5x83.5@2x.png (167px) - iPad
• Icon-1024.png (1024px) - App Store

Generation:

• Open ios/[ProjectName].xcworkspace → Assets catalog
• Xcode auto-generates required sizes

📋 Icon Guidelines

• Shape: Perfect square (1:1 aspect ratio)
• Background: Transparent or solid matching your theme
• Content: Centered, no text in icons
• Padding: 10-20% padding around main content
• Source Size: Start with 1024x1024px minimum

🔍 Testing

Android

npx react-native run-android --reset-cache
# Check launcher icon on home screen

iOS

npx react-native run-ios --reset-cache
# Check SpringBoard icon

⚠️ Troubleshooting

Icons not updating:

• Kill/restart app completely
• Clear launcher cache on Android
• Clean Xcode build on iOS

Icons blurry:

• Use 1024px+ source image
• Verify PNG transparency
• Check file dimensions match requirements