iOS Export Bundle

The iOS export bundle generates a complete AppIcon.appiconset folder ready to drop into your Xcode project. It includes all required icon sizes for iPhone, iPad, and App Store submission.

What's Included

The bundle contains a complete Xcode asset catalog folder:

AppIcon.appiconset/
├── Contents.json           # Xcode manifest
├── AppIcon-40x40.png       # iPhone notification @2x
├── AppIcon-58x58.png       # iPhone settings @2x
├── AppIcon-60x60.png       # iPhone notification @3x
├── AppIcon-80x80.png       # iPhone/iPad spotlight @2x
├── AppIcon-87x87.png       # iPhone settings @3x
├── AppIcon-120x120.png     # iPhone spotlight @3x, app @2x
├── AppIcon-152x152.png     # iPad app @2x
├── AppIcon-167x167.png     # iPad Pro app @2x
├── AppIcon-180x180.png     # iPhone app @3x
└── AppIcon-1024x1024.png   # App Store marketing

Icon Size Reference

Installation

Option 1: Drag and Drop (Recommended)

1. Extract the ZIP file
2. Open your Xcode project
3. Navigate to Assets.xcassets in the Project Navigator
4. Delete the existing AppIcon asset (right-click → Delete)
5. Drag the AppIcon.appiconset folder into Assets.xcassets

Option 2: Finder Replace

1. Extract the ZIP file
2. Open your project's Assets.xcassets in Finder:

   open YourProject/Assets.xcassets

3. Replace the existing AppIcon.appiconset folder with the downloaded one

Option 3: Xcode Assets Editor

1. Open Assets.xcassets → AppIcon in Xcode
2. Drag each PNG file from the extracted folder to the corresponding slot
3. Xcode will automatically match sizes based on filenames

Verification

After importing, verify in Xcode:

1. Open Assets.xcassets → AppIcon
2. All slots should show your icon with no yellow warnings
3. If you see warnings, a required size is missing

Building and Testing

# Build for simulator
xcodebuild -scheme YourApp -destination 'platform=iOS Simulator,name=iPhone 15'

# Or use Xcode: Product → Run (⌘R)

Test these locations:

• Home screen: App icon appears correctly
• Settings app: Your icon shows in Settings
• App Switcher: Icon displays when switching apps
• Spotlight: Icon appears in search results

App Store Submission

The bundle includes the required 1024×1024 App Store marketing icon. When you archive your app for submission, Xcode automatically uses this icon.

Important: The App Store icon must:

• Be exactly 1024×1024 pixels
• Have no transparency
• Have no rounded corners (Apple applies these automatically)

SwiftUI Projects

For SwiftUI projects created with Xcode 14+, the process is identical. The Assets.xcassets folder is created automatically with your project.

React Native / Expo

For React Native projects:

1. Extract the ZIP
2. Copy AppIcon.appiconset to:

   ios/YourApp/Images.xcassets/AppIcon.appiconset

3. Rebuild the iOS app

For Expo managed projects:

// app.json
{
  "expo": {
    "ios": {
      "icon": "./path/to/1024x1024.png"
    }
  }
}

Troubleshooting

Yellow warnings in Xcode?

This means a required size is missing. Check that all files from the bundle were copied correctly.

Icon not updating on device?

1. Delete the app from the device/simulator
2. Clean the build folder: Product → Clean Build Folder (⌘+Shift+K)
3. Rebuild and run

App Store rejection for icon issues?

Common reasons:

• Icon has transparency (use solid background)
• Icon has rounded corners (Apple adds these)
• Wrong file format (must be PNG)
• Missing 1024×1024 marketing icon

The Favycons bundle avoids all these issues by generating properly formatted icons with square corners and solid backgrounds.