Mobile App Icon Generation

Generate professional app icons using OpenAI or Gemini image generation APIs.

Configuration

Check if ~/.claude/plugins/mobile-app-icon/config.json exists (user config is stored at this fixed path, not in the plugin cache).

If missing, tell the user:

Create ~/.claude/plugins/mobile-app-icon/config.json with:

{
  "openai_api_key": "sk-...",
  "gemini_api_key": "..."
}

Include whichever API keys you want to use.

Generating Icons

${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "PROMPT" [OPTIONS]

Options

| Option | Values | Default | |--------|--------|---------| | --model | OpenAI: gpt-image-1, dall-e-3, dall-e-2. Gemini: gemini (Gemini 3 Pro), gemini-flash (Gemini 2.5 Flash) | gpt-image-1 | | --size | OpenAI only (see sizes below) | 1024x1024 | | --aspect-ratio | Gemini only: 1:1, 16:9, 9:16, 4:3, 3:4 | 1:1 | | --quality | auto, high, medium, low, hd, standard | auto | | --style | See styles below | none | | --raw | Use prompt verbatim | flag | | --num | 1-10 (OpenAI only, dall-e-3 supports only 1) | 1 | | --background | auto, transparent, opaque (gpt-image-1 only) | auto | | --output | Output filename | icon.png |

OpenAI Model Sizes

• gpt-image-1: 1024x1024, 1536x1024, 1024x1536, auto
• dall-e-3: 1024x1024, 1792x1024, 1024x1792
• dall-e-2: 256x256, 512x512, 1024x1024

Available Styles

| Style | Description | |-------|-------------| | minimalism | Clean, simple lines with 2-3 colors. Apple-inspired. | | glassy | Semi-transparent glass elements with soft color blending. | | woven | Textile-inspired patterns with woven textures. | | geometric | Bold geometric shapes with mathematical precision. | | neon | Electric neon colors on dark background. Cyberpunk. | | gradient | Smooth, vibrant gradients. Instagram-inspired. | | flat | Solid colors, no gradients/shadows. Microsoft-inspired. | | material | Google Material Design with bold colors. | | ios-classic | Traditional iOS with subtle gradients. | | android-material | Android Material Design 3. | | pixel | Retro 8-bit/16-bit pixel art style. | | game | Vibrant gaming aesthetics with bold colors. | | clay | Soft clay/plasticine textures. Playful aesthetic. | | holographic | Iridescent rainbow-shifting metallic effects. |

Examples

# OpenAI - basic icon
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "a rocket ship"

# OpenAI - with style
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "a coffee cup" --style minimalism

# OpenAI - transparent background
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "a star" --background transparent

# Gemini - basic icon
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "a rocket ship" --model gemini

# Gemini - square aspect ratio for app icon
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "a music note" --model gemini --aspect-ratio 1:1

# Raw prompt (no enhancement)
${CLAUDE_PLUGIN_ROOT}/scripts/generate.sh "watercolor sunset" --raw

Output is saved to ~/.claude/plugins/mobile-app-icon/generated/.