ASO Toolkit

What it does

ASO Toolkit provides a full App Store Optimization workflow for iOS/macOS projects: discover project metadata, run keyword research, generate and validate localized metadata, capture and compose screenshots, generate icons with AI, perform compliance checks against Apple Review Guidelines, and push or pull metadata via App Store Connect. It includes CLI scripts to automate init, research, metadata generation, screenshot capture/composition, icon generation, translation, competitor analysis, and compliance scoring.

When to use it

Use when preparing or optimizing an App Store listing: before releases to improve discoverability, when localizing metadata for new markets, when creating marketing screenshots/icons, or to validate compliance prior to submission. Also useful in CI pipelines for automated checks and dry-run previews.

What's included

• Scripts: a scripts/run.sh driver for commands (init, research, metadata, push, pull, screenshots, icons, check, translate, score).
• References: documented character limits and recommended workflows for title, subtitle, keywords, descriptions, plus integration notes for Gemini API and App Store Connect.
• Instructions: step-by-step usage patterns (init first, run research, export or push with dry-run options), dependency notes (Xcode, asc CLI, jq), and credential handling guidance.

Compatible agents

Designed for Claude Code / terminal-oriented agent environments on macOS where Xcode and asc CLI are available. AI features require a GEMINI_API_KEY for image/icon composition.