Kappmaker Asc

KAppMaker — App Store Connect

Before running any command

1. Prerequisites — kappmaker --version (install: npm i -g kappmaker). If a credential is missing the CLI says so; re-run kappmaker config init.
2. Read AiGuidelines/ first — the PRD, positioning and UI spec already answer most questions.

create-appstore-app — App Store Connect Setup

Syntax: kappmaker create-appstore-app [--config <path>]

Prerequisites:

• asc CLI installed ≥ 1.4.0 (brew install asc or brew upgrade asc; the bulk-CSV subscriptions pricing prices import command used by KAppMaker 1.7.0+ requires this version)
• Repo location: https://github.com/rorkai/App-Store-Connect-CLI (renamed from rudrankriyam in 2026)
• Config keys: ascKeyId, ascIssuerId, ascPrivateKeyPath (for API auth)
• appleId — now required (used by both asc web apps create and privacy setup)

Config file: Looks for ./Assets/appstore-config.json. If not found, prompts interactively.

• Global defaults at ~/.config/kappmaker/appstore-defaults.json are used as base layer.

What it does (13 steps): Register bundle ID + enable capabilities (Sign in with Apple, In-App Purchases, Push Notifications), create/find app (fully automated — no manual ASC step needed), set content rights, create version, set categories, age rating, localizations, pricing, subscriptions, consumable in-app purchases (credit packs), privacy, encryption, review contact.

Default credit packs: 3 CONSUMABLE IAPs ship in the template (Basic 10 credits / $4.99, Pro 30 / $9.99, Ultimate 80 / $19.99). Auto-fill turns each into credit_pack_{credits}_{priceDigits}_{appname} (e.g. credit_pack_10_499_myapp) — same product ID is used on Google Play and Adapty so the app code only needs one constant. Credit-pack auto-fill triggers on any in_app_purchases[] entry with a credits numeric field; other custom IAPs are left alone (the user's product_id wins). Created via asc iap setup — idempotent on rerun.

Tip: Before running, you can help the user review or create the Assets/appstore-config.json file. Read the existing config and explain each section. The user can edit it before running.

Per-territory PPP pricing (1.7.0+ — bulk CSV import): subscriptions and IAPs are fanned out to every ASC territory (~175) with PPP-adjusted prices in ONE API call per product.

• Subscriptions: asc subscriptions pricing prices import --input <csv> (added in asc 1.4.0). CSV columns territory,price,price_point_id; KAppMaker writes a temp file and pipes it in. Omits --start-date so rows are treated as starting prices (Apple rejects future-dated rows when the territory has no starting price yet: "Create a starting price before creating future prices").
• IAPs: asc iap pricing schedules create --prices "PP_ID:DATE,…" (already batch).
• Tier resolution: Apple's price-point catalog uses globally-stable tier numbers (1..800; tier N = same USD-equivalent across all territories). Resolve each unique PPP USD target → tier ONCE via USA's catalog (USD-priced), then synthesise per-territory price-point IDs locally using Apple's base64 {s, t, p} format. Critical bug fix vs 1.6.x — old code numerically compared a USD target to local-currency prices (¥, ₩, ₹) and picked the FREE tier, silently landing products at $0 in JPN/IDR/INR/KRW/etc.
• Distinct catalogs, distinct IDs: subscriptions = subscriptionPricePoints (s = subscription-internal ID); IAPs = appPricePoints (s = app ID). Mixing IDs returns 400 The provided entity is invalid.
• Idempotent re-runs: existing subs/IAPs now refresh pricing instead of being skipped (1.6.x silently skipped → users couldn't re-price legacy products).

App Review screenshots (1.7.1+): Apple requires a review screenshot on every subscription and IAP — without one, products stay in MISSING_METADATA state. Config field review_screenshot (top-level, plus optional per-product override on each sub/IAP). Required size: 1290 × 2796 px (iPhone 6.7" Display, portrait — matches App Store listing screenshots); minimum 640 × 920 px. Uploads via asc subscriptions review screenshots create (subs) and asc iap images create (IAPs). Idempotent during create-appstore-app (skips when one is already attached); silently skipped when the file at the given path doesn't exist.

Auto-resize prompt (1.7.3+): when the file's dimensions don't match 1290 × 2796, KAppMaker prompts Resize to 1290×2796 keeping aspect ratio? (Y/n). Y → sharp resize with fit: 'inside' (preserves aspect ratio, may produce 1290×726 from a 16:9 source) → temp file → upload. N → uploads as-is. Files already at 1290×2796 skip the prompt.

Standalone monetization push (appstore-monetization-push): when the user wants to re-sync subscriptions + IAPs (refresh PPP pricing, add a new product from the config) without running the full 13-step create-appstore-app flow, use kappmaker appstore-monetization-push [--subscriptions-only | --iap-only] [-c|--config <path>]. Reads Assets/appstore-config.json, resolves the app by app.id or app.bundle_id, then calls the same setupSubscriptions / setupInAppPurchases functions — fully idempotent (existing products get pricing refreshed).

Standalone REPLACE commands (1.7.3+ — appstore- prefix) for swapping screenshots without re-running the full setup flow:

• kappmaker appstore-update-subscription-review-screenshot [--file <path>] [--config <path>] [--product-id <id>]
• kappmaker appstore-update-iap-review-screenshot [--file <path>] [--config <path>] [--product-id <id>]

--file applies to all matched products; without it, the commands use the per-product review_screenshot from the config. --product-id targets a single product. These commands FORCE-REPLACE existing screenshots by delete+create — empirically asc … update (both screenshots update and images update --file) doesn't actually swap the file on Apple's side, only marks the record as "uploaded".

Where this sits in the flow

• Before this: kappmaker-new-app (bundle ID comes from the project).
• After this: kappmaker-aso-metadata for the listing text, kappmaker-screenshots, then kappmaker-publish.