generate_app_icon

═══════════════════════════════════════════════════════════════════════════════ 🍏 APP ICON & LOGO GENERATOR (square · transparent · ready for .iconset) ═══════════════════════════════════════════════════════════════════════════════

Use THIS tool — not generate_image — whenever the user asks for an app icon, application icon, .icns, .iconset, macOS/iOS/Android icon, favicon, logo, logomark, or brand mark. It is purpose-built for that job and removes every way to get it wrong.

🔒 WHAT IS FORCED (you cannot override these — by design): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • TRANSPARENT background — ALWAYS. Every result is a real alpha-channel PNG cut-out. There is no opaque-background option, because an icon or logo with a baked-in rectangle behind it is wrong. The transparent file path comes back as "transparent_path". • 1:1 SQUARE — ALWAYS. Every app icon is square; there is no aspect-ratio knob to get wrong. • 1K (1024px) — ALWAYS. This is the master size every .iconset slice and store listing is downscaled from. • PNG — ALWAYS. The lossless alpha format icons ship in. • CUT-OUT ONLY — ALWAYS. Only the transparent PNG is written; the pass-1 (white-background) original is never kept.

⛔ HOW TO WRITE THE PROMPT (READ THIS — the tool enforces it): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ This tool IS the app-icon maker. Your prompt must describe ONLY the subject/artwork — NOTHING about the deliverable. Do NOT write "app icon", "application icon", "make an icon of", "logo of", "squircle", or anything about output/format/shape. The tool turns your subject INTO the icon.

WRONG: "an app icon of a blue magnifying glass over a network" RIGHT: "a glowing electric-blue magnifying glass over a network graph"

If your prompt contains "app icon", "logo", "favicon", "squircle" (or similar framing), the tool will REJECT the call and make you rewrite it. Just describe the picture.

The ONLY exception is when one of those words is genuinely PART OF THE SUBJECT you are depicting — e.g. a neon sign that literally reads "LOGO", or a picture OF a favicon. In that rare case, set allow_icon_words_in_prompt=True to bypass the check. Do NOT use it just to sneak deliverable-framing past the guard.

📋 PARAMETERS (what you DO control): ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ► prompt (required, str): Describe ONLY the subject/artwork itself — see the rule above. Don't ask for a background, a rectangle, a drop shadow, or a presentation surface. A bold, simple, single focal form reads best at small sizes.

► reference_image_paths (optional, str | list[str]): Brand/style reference image path(s), up to 14 (e.g. an existing logomark or palette to stay consistent with).

► enable_google_search / enable_image_search (optional, bool): Ground the design in real brand/product references found on the web.

► thinking_level (optional, str, default: "high"): "minimal" or "high". Defaults to "high" — icons reward the extra composition reasoning.

► allow_icon_words_in_prompt (optional, bool, default: False): Escape hatch for the prompt guard. Leave False. Set True ONLY when a word like "logo"/"favicon" is literally part of the subject you are depicting (e.g. a neon sign reading "LOGO"), not framing of the deliverable. Misusing this to bypass the guard defeats the point.

📤 RESULT / NEXT STEPS: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Use result["images"][0]["transparent_path"] — that is the square, transparent 1024px PNG. Tell the user the exact path and open it in the native OS viewer (macOS: open "<path>"). To ship a macOS app, drop it into a .iconset directory and run iconutil -c icns <name>.iconset. For an iOS App Store upload, flatten onto an opaque background first (Apple rejects icons that contain an alpha channel).