Android App Icon

Android App Icon

Generate Android adaptive icons using VectorDrawables from Iconify's 200k+ icon library.

How This Skill Works

This skill uses executable scripts for reliable, deterministic icon generation. The agent's role is to:

1. Run scripts with user-confirmed parameters
2. Present results and wait for user decisions
3. Verify output

Scripts location: ~/​claude-devtools/​skills/​android-app-icon/​scripts/

---

Checklist

Prerequisites

• Project has minSdk >= 26 → Verify
• curl is installed
• python3 is installed
• rsvg-convert is installed → Install instructions

Steps

• Step 1: Check for existing legacy icons → Details
• ⏸️ WAIT: If legacy icons found, ask user whether to delete them
• Step 2: Get search term from user → Details
• ⏸️ WAIT: User confirms or provides search term
• Step 3: Run search script → Details
• ⏸️ WAIT: User selects icon from results
• Step 4: Run generate script → Details
• Step 5: Verify build → Details

Completion Criteria

• All legacy icons removed (if user confirmed)
• app/​src/​main/​res/​drawable/​ic_launcher_foreground.xml exists
• app/​src/​main/​res/​drawable/​ic_launcher_background.xml exists
• app/​src/​main/​res/​mipmap-anydpi-v26/​ic_launcher.xml exists
• app/​src/​main/​res/​mipmap-anydpi-v26/​ic_launcher_round.xml exists
• fastlane/​metadata/​android/​en-US/​images/​icon.png exists
• ./​gradlew assembleDebug succeeds

---

Reference Details

Verifying minSdk

Check app/​build.gradle.kts or app/​build.gradle:

android {
    defaultConfig {
        minSdk = 26  // Must be 26 or higher
    }
}

Installing rsvg-convert

macOS:

brew install librsvg

Ubuntu/​Debian:

sudo apt install librsvg2-bin

Verify:

rsvg-convert --version

---

Step 1: Check for Existing Legacy Icons

Check for legacy raster icons that are not needed for minSdk 26+:

find app/​src/​main/​res/​mipmap-mdpi app/​src/​main/​res/​mipmap-hdpi \
     app/​src/​main/​res/​mipmap-xhdpi app/​src/​main/​res/​mipmap-xxhdpi \
     app/​src/​main/​res/​mipmap-xxxhdpi \
     \( -name "ic_launcher*.webp" -o -name "ic_launcher*.png" \) \
     2>/​dev/​null

If files are found, present to user:

"I found existing legacy icon files:

• mipmap-mdpi/​ic_launcher.webp
• mipmap-hdpi/​ic_launcher.webp
• ... (list all)

These are not needed for minSdk 26+ (VectorDrawables are used instead).

Would you like me to delete them? (y/​n)"

If user confirms deletion:

find app/​src/​main/​res/​mipmap-mdpi app/​src/​main/​res/​mipmap-hdpi \
     app/​src/​main/​res/​mipmap-xhdpi app/​src/​main/​res/​mipmap-xxhdpi \
     app/​src/​main/​res/​mipmap-xxxhdpi \
     \( -name "ic_launcher*.webp" -o -name "ic_launcher*.png" \) \
     -delete 2>/​dev/​null

---

Step 2: Get Search Term

Auto-detect from project context:

# From package name in build.gradle.kts
grep -E 'namespace|applicationId' app/​build.gradle.kts 2>/​dev/​null

# From app name in strings.xml
grep 'name="app_name"' app/​src/​main/​res/​values/​strings.xml 2>/​dev/​null

Present to user:

"Based on your project, I suggest searching for: {detected_term}

Would you like to:

1. Use {detected_term}
2. Enter a different search term"

---

Step 3: Search for Icons

Run the search script with the confirmed search term:

~/​claude-devtools/​skills/​android-app-icon/​scripts/​search-icons.sh "<search-term>"

Present results to user:

"Found icons matching '{search-term}':

1. mdi:heart-pulse - Material Design Icons (Apache 2.0)
2. healthicons:health-worker - Health Icons (MIT)
3. ...

Preview: https://icon-sets.iconify.design/mdi/heart-pulse/

Enter a number to select, or type a different search term:"

---

Step 4: Generate Icons

Run the generate script from the project root:

cd /​path/​to/​android/​project
~/​claude-devtools/​skills/​android-app-icon/​scripts/​generate-app-icons.sh "<icon-id>"

The script auto-detects:

• Background color from themes.xml → colors.xml
• Scale factor (default 1.15)
• Output paths

Optional overrides (if user requests):

ICON_BACKGROUND="#2196F3" ICON_SCALE="1.2" \
  ~/​claude-devtools/​skills/​android-app-icon/​scripts/​generate-app-icons.sh <icon-id>

---

Step 5: Verify

./​gradlew assembleDebug

Check all files exist:

test -f app/​src/​main/​res/​drawable/​ic_launcher_foreground.xml && echo "✓ foreground"
test -f app/​src/​main/​res/​drawable/​ic_launcher_background.xml && echo "✓ background"
test -f app/​src/​main/​res/​mipmap-anydpi-v26/​ic_launcher.xml && echo "✓ ic_launcher"
test -f app/​src/​main/​res/​mipmap-anydpi-v26/​ic_launcher_round.xml && echo "✓ ic_launcher_round"
test -f fastlane/​metadata/​android/​en-US/​images/​icon.png && echo "✓ play store icon"

---

Troubleshooting

Icon appears cut off

Reduce scale: ICON_SCALE=1.0 generate-app-icons.sh <icon>

rsvg-convert not found

See Installing rsvg-convert

Icon not found

Verify icon ID at https://icon-sets.iconify.design/