generate_icon

Generate professional app icons using AI from prompts, metadata, or reference images.

Description

This tool generates a single app icon using Gemini 3 Pro Image. You can provide a text prompt, app metadata, or a reference image to guide the generation. The icon is automatically resized to iOS (1024×1024) and Android (512×512) formats.

Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project ID to associate the icon with
`prompt`	`string`	Conditional	Direct text prompt for icon generation
`appMetadata`	`object`	Conditional	App metadata object with title, category, description
`referenceImageUrl`	`string`	Conditional	URL to a reference icon to use as inspiration
`appStoreId`	`string`	Conditional	App Store ID to fetch existing icon as reference
`style`	`string`	No	Icon style: flat, 3d, minimalist, cute, gradient
`colors`	`object`	No	Color preferences with primary and secondary hex values
`background`	`string`	No	Background type: solid or gradient

Source Types

You must provide one of: prompt, appMetadata,referenceImageUrl, or appStoreId. These are mutually exclusive source types for icon generation.

Example Usage

Ask Claude to generate an icon:

Natural Language Promptstext

"Generate an app icon for a fitness app with a dumbbell"

"Create a minimalist icon for my productivity app called TaskFlow"

"Generate a 3D style icon with blue and purple colors"

"Make an icon based on my app's metadata in the project"

"Create a variation of the Spotify icon for my music app"

Response

{
  "success": true,
  "icon": {
    "originalUrl": "https://cdn.appstorecopilot.com/icons/icon-original-123.png",
    "ios": "https://cdn.appstorecopilot.com/icons/icon-ios-123.png",
    "android": "https://cdn.appstorecopilot.com/icons/icon-android-123.png"
  }
}

Available Styles

flat

Solid colors, clean geometric shapes, no shadows or 3D effects

3d

3D rendered with depth, subtle shadows, glossy or matte finish

minimalist

Ultra minimalist with maximum negative space, single simple shape

cute

Kawaii style with rounded shapes, friendly character or mascot

gradient

Modern gradient colors with smooth transitions, glass-morphism effect

Output Formats

Platform	Size	Format	Notes
iOS	1024×1024	PNG (sRGB)	System applies squircle mask automatically
Android	512×512	PNG (32-bit)	System applies rounded corners automatically

Design Tips

For best results: use a single centered focal element, avoid text unless brand-critical, and don't add rounded corners (platforms add them automatically).

Credits

Each icon generation uses one icon credit from your plan. Use generate_icon_variations to generate multiple style variations at once.