ASO Studio is now a four-tool monorepo. What was previously a standalone keyword tracker is now the indie iOS App Store toolkit — keyword tracking, AI screenshot generation, PPO experiments, and a UGC video pipeline, all under one dashboard with a single key vault.
⚠ Force-pushed restructure — directory layout and tag history have been reset to support the monorepo. Existing clones will need to re-clone.
What's new
Sub-tools
- Keywords (was the entire repo before) — rank tracking dashboard with snapshot heartbeat/watchdog/dedupe, Analytics screen, full Apple storefront coverage (50+ countries).
- Screenshots — App Store screenshot generator with AI hero enhancement (fal.ai gpt-image-2). Templates, scaffolds, headline overlays, locale translations, ASC-ready PNG export at correct dimensions (1290×2796 for iPhone 6.9″, 2064×2752 for iPad 13″).
- PPO Experiments — multi-strategy A/B treatment generator. Upload source screens once, generate per-strategy variants with different visual concepts, export ZIPs ready for App Store Connect PPO.
- Video (beta) — UGC video pipeline node graph editor (ComfyUI-style) for ad creative. Curated starter pack of workflows + influencer presets shipped in the repo (`workflows/`, `influencer/`).
Cross-cutting improvements
- Unified Settings UI — gear icon in every sub-tool's TopBar opens the same modal. Single key vault at `~/.aso-studio/keys.json` (mode 0600, owner-only) — never touched by any process other than the studio backend; never sent anywhere except the API endpoints they belong to.
- Masked password inputs with 👁 reveal toggle so you can verify what you've pasted without exposing the saved value.
- Reverse-proxied dev architecture — `aso-keywords` serves at :5173 and proxies `/studio*` and `/video*` to the corresponding sub-app dev servers. One URL, one origin, no CORS config needed.
- AI generation hardening — fal.ai requests now use `queue.submit` + background polling so generations survive both browser refresh and server restart. 3-attempt retry with exponential backoff on transient errors. Boot-time recovery re-attaches polling for any in-flight job.
- Server-side image proxy with optional ASC-resize via Sharp Lanczos. Browser exports request `?exportSize=appstore-iphone|appstore-ipad` and get back PNGs at exact App Store Connect dimensions.
- `llms.txt` + `llms-full.txt` at root (llmstxt.org standard) — full architectural context, file map, state schema, and command examples for AI agents driving the studio end-to-end.
- README rewritten as monorepo overview with PPO render examples and ASO Video example clips embedded inline.
MCP integrations
ASO Studio pairs with two community MCP servers for full programmatic control of Apple's APIs:
- `asc-mcp` — App Store Connect API (builds, versions, screenshots, IAP, PPO experiments, custom product pages).
- `apple-search-ads-mcp` — Apple Ads (Search Ads) API v5 (campaigns, keywords, budget orders, reports).
Installation
```bash
git clone https://github.com/dsm5e/aso-tracker.git aso-studio
cd aso-studio
npm install
npm run dev
open http://localhost:5173
```
`FAL_API_KEY` (free signup, ~$0.05/render after $1 credit) and `OPENAI_API_KEY` (free signup, ~$0.0001/headline after $5 credit) are needed for AI features. Keyword tracking works without any keys.