guillempuche/app-asset-generator

Overview

This skill generates app icons, splash screens, and adaptive icons for iOS, Android, and Web from a single design configuration. It automates producing platform-ready asset sets, export folders, and an integration instruction file to speed up app visual setup and updates.

How this skill works

Provide a design configuration via CLI flags or the interactive TUI and the tool renders all required sizes and variants. It supports text-based icons, gradients, custom scales, dark-mode variants, and platform selection, then writes outputs into a timestamped assets folder with an INSTRUCTIONS file. A JSON output mode enables automation and CI integration.

When to use it

• Creating a new app and you need consistent icons and splash screens for iOS, Android, and Web.
• Updating brand visuals across platforms and needing exactly scaled assets and dark-mode variants.
• Automating asset generation in CI/CD or build pipelines using JSON output.
• Generating adaptive icons and platform-specific launch images from a single source.
• Quickly iterating on icon scale, font, or gradient options during design reviews.

Best practices

• Start from a single high-resolution source and use the TUI for visual previews before exporting.
• Use --format json and --quiet for non-interactive CI runs to capture structured output.
• Follow scale guidelines: icon-scale 0.6–0.7 for standard, 0.8–0.9 for bold styling; splash-scale 0.2–0.3 for standard.
• Include both light and dark mode configs to generate matching variants for modern platforms.
• Scope generation to specific platforms with --platforms to save time during targeted updates.

Example use cases

• Generate a set of launcher and adaptive icons for Android and app icons/splashes for iOS before release.
• Produce PWA icons and favicons for web distribution while keeping mobile assets synchronized.
• Run a CI job that regenerates assets after brand color or typography changes using JSON output.
• Create a bold, high-contrast app icon for marketing builds by increasing icon-scale and using a gradient background.
• Quickly produce dark-mode icon variants for an app update with the --dark-mode flags.