# Ascelerate > Use when working with App Store Connect tasks — app submissions, localizations, screenshots, builds, provisioning, in-app purchases, subscriptions, or release workflows. Triggers on App Store, App Store Connect, asc, ascelerate, app review, provisioning profiles, screenshots, localizations, IAP, subscriptions. - Skill: `keremerkan/ascelerate` (Agent Skill) - Install (CLI): `npx skillmds@latest add keremerkan/ascelerate` - Raw SKILL.md: https://api.skillmd.com/api/skills/keremerkan/ascelerate/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: keremerkan (https://skillmd.com/u/keremerkan) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/keremerkan/ascelerate --- # ascelerate A command-line tool for the App Store Connect API. Use `ascelerate` for all App Store Connect operations instead of the web interface. ## Quick Reference ### App aliases Use aliases instead of full bundle IDs: ```bash ascelerate alias add myapp # Interactive app picker ascelerate apps info myapp # Use alias anywhere ``` Any argument without a dot is treated as an alias. Real bundle IDs work unchanged. ### JSON output Read commands support `--json` for machine-readable output — prefer it over parsing tables: ```bash ascelerate apps list --json ascelerate apps info --json ascelerate apps versions --json ascelerate apps review preflight --json # {passed, checks: [{group?, name, passed, detail}]}; exits non-zero on failures ascelerate apps review status --json # submissions incl. per-item states ascelerate builds list --bundle-id --json ascelerate testflight builds --json ascelerate testflight status --json ascelerate reviews list --json # includes full review bodies + developer responses (no per-review info calls needed) ascelerate reviews info --json ascelerate iap list --json ascelerate iap info --json # includes "hasPricing" boolean ascelerate iap pricing show --json ascelerate sub groups --json ascelerate sub list --json ascelerate sub info --json # includes "hasPricing" boolean ascelerate sub pricing show --json ascelerate rate-limit --json ``` Conventions: list commands emit a top-level JSON array, detail commands a single object; raw API enum values (`WAITING_FOR_REVIEW`, `IOS`); ISO 8601 dates; resource `id` always included; null fields omitted; empty results emit `[]`. `--json` implies non-interactive — ambiguity errors instead of prompting (disambiguate with `--platform` etc.). Errors go to stderr, so stdout is always valid JSON. ### Version management ```bash ascelerate apps create-version ascelerate apps copyright --set "2026 Your Name" # View/update version copyright ascelerate apps build attach-latest ascelerate apps build attach # Interactive build picker ascelerate apps build detach ``` `--version` targets a specific version. Without it, commands prefer the latest editable version (Prepare for Submission or Waiting for Review). Universal-purchase apps (one app record, several platforms) can hold the same version per platform. Version-scoped commands (localizations, media, build attach, review, `builds list`/`await-processing`) accept `--platform ios|macos|tvos|visionos` to disambiguate; without it they prompt when ambiguous. `apps create-version` and `apps review submit` default to iOS — pass `--platform macos` for the Mac version/submission. ### Localizations Two layers: **version-level** (description, what's new, keywords) and **app-level** (name, subtitle, privacy URL). ```bash # Version localizations ascelerate apps localizations export ascelerate apps localizations import --file localizations.json # App info localizations ascelerate apps app-info export ascelerate apps app-info import --file app-infos.json ``` #### Version localization JSON format ```json { "en-US": { "description": "App description.", "whatsNew": "- Bug fixes", "keywords": "keyword1,keyword2", "promotionalText": "Promo text", "marketingURL": "https://example.com", "supportURL": "https://example.com/support" } } ``` #### App info localization JSON format ```json { "en-US": { "name": "My App", "subtitle": "Best app ever", "privacyPolicyURL": "https://example.com/privacy", "privacyChoicesURL": "https://example.com/choices" } } ``` Only fields present in the JSON get updated — omitted fields are left unchanged. Import commands create missing locales automatically with confirmation. ### Screenshots & App Previews ```bash ascelerate apps media download ascelerate apps media upload media/ ascelerate apps media upload screenshots.zip # Zip/tar/tar.gz support ascelerate apps media upload # Interactive picker ascelerate apps media upload media/ --replace # Replace existing ascelerate apps media verify # Check processing status ascelerate apps media verify media/ # Retry stuck items ascelerate apps media prune media/ # Delete server sets with no matching local folder ``` #### Folder structure ``` media/ ├── en-US/ │ ├── APP_IPHONE_67/ │ │ ├── 01_home.png │ │ └── 02_settings.png │ └── APP_IPAD_PRO_3GEN_129/ │ └── 01_home.png └── de-DE/ └── APP_IPHONE_67/ └── 01_home.png ``` Required display types: `APP_IPHONE_67` (iPhone) and `APP_IPAD_PRO_3GEN_129` (iPad). Files sorted alphabetically = upload order. Images become screenshots, videos become previews. ### Review submission ```bash ascelerate apps review preflight # Pre-submission checks ascelerate apps review submit # Submit (offers to include IAPs/subs) ascelerate apps review status # Check status ascelerate apps review resolve-issues # After fixing rejection ascelerate apps review cancel-submission # Cancel active review ascelerate apps release # Release an approved version in Pending Developer Release ascelerate apps review info # View App Review Information ascelerate apps review info [--contact-email X] [--demo-account-name X] [--demo-account-password X] [--demo-account-required true|false] [--notes X] # Update (per-version upsert; omitted fields unchanged) ascelerate apps review attachment list [--version X] ascelerate apps review attachment upload [--version X] # reserve/PUT/commit; any file type ascelerate apps review attachment delete ``` `preflight` checks build attachment, localizations, app info, screenshots across all locales, plus IAP/subscription state and pricing (warns when an IAP has no price schedule or a sub has no prices). Exits non-zero on failures. With `--json` it emits the structured check list (same exit code) — ideal as a CI gate. When submitting, the tool detects IAPs and subscriptions and offers to submit them alongside the app version. ### In-app purchases ```bash ascelerate iap list ascelerate iap info # warns if no price schedule set # Promoted purchases (IAPs or subscriptions, shown on the App Store product page) ascelerate iap promoted list ascelerate iap promoted add [--visible-for-all true|false] [--enabled true|false] ascelerate iap promoted remove ascelerate iap promoted reorder # omitted ones appended after ascelerate iap promoted toggle --enabled true|false ascelerate iap create --name "Name" --product-id --type CONSUMABLE ascelerate iap update --name "New Name" ascelerate iap delete ascelerate iap submit # Localizations ascelerate iap localizations view ascelerate iap localizations export ascelerate iap localizations import --file iap-de.json # Pricing — wholesale schedule POST is read-modify-write, preserves overrides ascelerate iap pricing show ascelerate iap pricing tiers --territory USA ascelerate iap pricing set --price 4.99 [--base-territory USA] [--remove-all-overrides] ascelerate iap pricing override --price 5.99 --territory FRA ascelerate iap pricing remove --territory FRA # revert to auto-equalize ascelerate iap pricing export [--output prices.json] ascelerate iap pricing import [--file prices.json] # copy schedule from another product/app # Per-IAP territory availability (independent of app's) ascelerate iap availability [--add CHN,RUS] [--remove ITA] [--available-in-new-territories true] # Offer codes (one-time-use batches + custom codes) ascelerate iap offer-code list ascelerate iap offer-code info ascelerate iap offer-code create --name X --eligibility NON_SPENDER,ACTIVE_SPENDER --price 0.99 [--territory USA] [--equalize-all-territories] ascelerate iap offer-code toggle --active true ascelerate iap offer-code gen-codes --count 100 --expires 2026-12-31 ascelerate iap offer-code add-custom-codes --code PROMO2026 --count 1000 --expires 2026-12-31 ascelerate iap offer-code view-codes [--output codes.txt] # async; may need retry # Promotional images + App Review screenshot (Apple's 3-step file upload flow) ascelerate iap images list/upload/delete [|] ascelerate iap review-screenshot view/upload/delete [] # one screenshot per IAP ``` IAP types: `CONSUMABLE`, `NON_CONSUMABLE`, `NON_RENEWING_SUBSCRIPTION`. Offer code eligibilities: `NON_SPENDER`, `ACTIVE_SPENDER`, `CHURNED_SPENDER`. Pricing notes: - `set` preserves per-territory overrides by default; interactive menu offers to drop them, or `--remove-all-overrides` for non-interactive wipe. - `override` and `remove` only operate on non-base territories. - `export`/`import` copy the schedule between products (any app): a JSON file of customer prices keyed by territory, matched to the target's own tiers by price on import. Import replaces the schedule wholesale — territories not in the file revert to auto-equalize; a schedule already matching the file is a no-op. - One-time-use offer codes generate asynchronously — `gen-codes` returns a batch ID; use `view-codes ` to fetch values once ready. ### Subscriptions ```bash ascelerate sub list ascelerate sub groups ascelerate sub info # warns if no prices set ascelerate sub create --name "Monthly" --product-id --period ONE_MONTH --group-id ascelerate sub update --name "New Name" ascelerate sub delete ascelerate sub submit ascelerate sub submit-group # submit whole group for review # Subscription localizations ascelerate sub localizations export ascelerate sub localizations import --file sub-de.json # Group management ascelerate sub create-group --name "Premium" ascelerate sub update-group --name "Premium Plus" ascelerate sub delete-group # Group localizations ascelerate sub group-localizations export ascelerate sub group-localizations import --file group-de.json # Pricing — per-territory; --equalize-all-territories fans out via Apple's equalizations ascelerate sub pricing show ascelerate sub pricing tiers --territory USA ascelerate sub pricing set --price 4.99 [--territory USA] [--equalize-all-territories] [--preserve-current | --no-preserve-current] # required on price increases [--confirm-decrease] # required on decreases in --yes mode ascelerate sub pricing export [--output prices.json] ascelerate sub pricing import [--file prices.json] # copy prices from another product/app; same safety flags as set # Per-subscription territory availability (independent of app's) ascelerate sub availability [--add CHN,RUS] [--remove ITA] [--available-in-new-territories true] # Introductory offers (free trials + intro discounts for NEW subscribers) ascelerate sub intro-offer list ascelerate sub intro-offer create --mode FREE_TRIAL --duration ONE_WEEK --periods 1 ascelerate sub intro-offer create --mode PAY_AS_YOU_GO --duration ONE_MONTH --periods 3 --territory USA --price 0.99 ascelerate sub intro-offer update --end-date 2026-12-31 ascelerate sub intro-offer delete # Promotional offers (server-signed offers for EXISTING subscribers) ascelerate sub promo-offer list/info/delete [] ascelerate sub promo-offer create --name X --code LOYALTY50 --mode PAY_AS_YOU_GO --duration ONE_MONTH --periods 3 --price 4.99 --territory USA --equalize-all-territories ascelerate sub promo-offer update --price 5.99 --equalize-all-territories # only prices can change # Offer codes (one-time-use batches + custom codes) ascelerate sub offer-code list/info [] ascelerate sub offer-code create --name X --eligibility NEW --offer-eligibility STACK_WITH_INTRO_OFFERS --mode FREE_TRIAL --duration ONE_MONTH --periods 1 --price 0 --territory USA --equalize-all-territories ascelerate sub offer-code toggle --active true ascelerate sub offer-code gen-codes --count 500 --expires 2026-12-31 ascelerate sub offer-code add-custom-codes --code SUBPROMO --count 1000 --expires 2026-12-31 ascelerate sub offer-code view-codes [--output codes.txt] # Promotional images + App Review screenshot (Apple's 3-step file upload flow) ascelerate sub images list/upload/delete [|] ascelerate sub review-screenshot view/upload/delete [] # one screenshot per sub ``` Subscription pricing safety: - **Price increase** in any territory requires `--preserve-current` (grandfather existing subs at old price) OR `--no-preserve-current` (push new price after Apple's notification period). Errors if neither set. - **Price decrease** prompts interactively; under `--yes`, requires `--confirm-decrease` to acknowledge revenue impact. - **`--equalize-all-territories`** aggregates the analysis: if any territory in the fan-out is an increase, the preserve flag is required for all. - **`import`** applies the same aggregated rules; it only touches territories listed in the file and skips ones already at the listed price. - Transient ASC errors (429/5xx) during multi-territory writes are retried automatically (in-place backoff + end-of-run sweep). Remaining failures are listed with a re-run hint and exit non-zero — re-running retries only the failed territories. Offer code eligibilities for subs: `NEW`, `EXISTING`, `EXPIRED`. Offer eligibility: `STACK_WITH_INTRO_OFFERS` or `REPLACE_INTRO_OFFERS`. Modes: `FREE_TRIAL`, `PAY_AS_YOU_GO`, `PAY_UP_FRONT`. NOT YET IMPLEMENTED: `sub win-back-offer` is blocked on asc-swift codegen (the inline price create type is missing required relationships). Custom product page search-keyword linkages are blocked by the same kind of codegen gap (the `AppKeyword` entity exposes no keyword text). `iap hosted-content` is intentionally skipped. ### Customer reviews ```bash ascelerate reviews list [--rating 1-5] [--territory USA] [--sort recent|oldest|critical|best] [--unanswered] [--limit 50] ascelerate reviews info # full text + developer response ascelerate reviews respond --body "..." # publish/replace developer response ascelerate reviews delete-response ``` Reviews are read-only; only the developer response is writable. Review IDs come from `reviews list`. Use `reviews list --json` to get full review bodies and existing developer responses in one call — no per-review `info` calls needed. The App Store Connect API does **not** expose aggregate rating counts or the star-rating average/histogram — only individual reviews (above). For download/unit numbers and revenue, use `reports` (below). ### Reports (downloads, proceeds, analytics) ```bash # Sales & Trends — units/downloads + proceeds. Summarizes units by title/product type. ascelerate reports sales [--frequency DAILY|WEEKLY|MONTHLY|YEARLY] [--date X] [--type SALES] [--sub-type SUMMARY] [--bundle-id ] [--vendor-number X] [--output report.tsv] [--raw] # Financial report — units + partner proceeds for a fiscal period. ascelerate reports finance --date YYYY-MM --region US [--type FINANCIAL|FINANCE_DETAIL] [--vendor-number X] [--output X] [--raw] # App Analytics — downloads, impressions, sessions, etc. (async: creates/reuses a report request, downloads segments). ascelerate reports analytics [--category APP_STORE_ENGAGEMENT|APP_USAGE|COMMERCE|FRAMEWORK_USAGE|PERFORMANCE] [--granularity DAILY|WEEKLY|MONTHLY] [--report-name X] [--processing-date YYYY-MM-DD] [--ongoing] [--output dir/] [-y] ``` - **Vendor number** is required for `sales`/`finance` (App Store Connect → Payments and Financial Reports). Save it once with `ascelerate configure`, or pass `--vendor-number`. - `sales`/`finance` default to a parsed **summary**; add `--raw` to print the TSV or `--output PATH` to save it. `--date` defaults to the most recent completed period for sales; for `finance` it's a *fiscal* period `YYYY-MM` (not a calendar month) and is required along with `--region`. - `analytics` reuses an existing report request or prompts to create one (a one-time snapshot by default; `--ongoing` for recurring). A freshly created snapshot isn't ready immediately — re-run the command after a few minutes to download the segments. ### In-app events ```bash ascelerate events list [--state PUBLISHED] ascelerate events info ascelerate events create --reference-name X [--badge SPECIAL_EVENT] [--purpose ATTRACT_NEW_USERS] [--priority HIGH] [--deep-link URL] [--primary-locale en-US] [--territories USA,GBR --publish-start 2026-07-01 --event-start 2026-07-05 --event-end 2026-07-12] ascelerate events update [--badge NONE] # --badge NONE clears the badge ascelerate events delete # Localizations (name, shortDescription, longDescription) ascelerate events localizations view ascelerate events localizations export ascelerate events localizations import --file event-locales.json # Media (png/jpg -> screenshot, mp4/mov -> video clip) ascelerate events media list ascelerate events media upload --locale en-US --asset-type EVENT_CARD|EVENT_DETAILS_PAGE [--preview-frame 00:00:03] ascelerate events media delete ``` Badges: `LIVE_EVENT`, `PREMIERE`, `CHALLENGE`, `COMPETITION`, `NEW_SEASON`, `MAJOR_UPDATE`, `SPECIAL_EVENT`. Purposes: `APPROPRIATE_FOR_ALL_USERS`, `ATTRACT_NEW_USERS`, `KEEP_ACTIVE_USERS_INFORMED`, `BRING_BACK_LAPSED_USERS`. Schedule dates: ISO8601 or `yyyy-MM-dd`. Event localization locales must match the app's locales (e.g. `tr`, not `tr-TR`). #### Event localization JSON format ```json { "en-US": { "name": "Summer Sale", "shortDescription": "...", "longDescription": "..." } } ``` ### Custom product pages ```bash ascelerate product-pages list ascelerate product-pages info ascelerate product-pages create --name X --locale en-US [--promotional-text "..."] # compound create (page + version + first locale) ascelerate product-pages update [--name X] [--visible true|false] ascelerate product-pages delete ascelerate product-pages localizations view ascelerate product-pages localizations export ascelerate product-pages localizations import --file page-locales.json # promotional text per locale # Media (png/jpg -> screenshot by --display-type, mp4/mov -> app preview by --preview-type; set auto-created) ascelerate product-pages media list ascelerate product-pages media upload --locale en-US --display-type APP_IPHONE_67 shot.png ascelerate product-pages media upload --locale en-US --preview-type APP_IPHONE_67 clip.mp4 [--preview-frame 00:00:03] ascelerate product-pages media delete ``` Pages are referenced by name or ID. `create` issues a compound POST (page + version + localization linked via `${local-id}` inline references). #### Custom product page localization JSON format ```json { "en-US": { "promotionalText": "Limited-time offer" } } ``` ### Screenshots (Simulator Capture) Capture App Store screenshots from simulators using UI tests. Replaces fastlane snapshot. ```bash ascelerate screenshot init # Generate config and helper in ascelerate/ directory ascelerate screenshot create-helper # Generate ScreenshotHelper.swift for UITest target ascelerate screenshot run # Capture screenshots ascelerate screenshot run -l en-US,tr-TR # Override languages (subset of configured), comma-separated ascelerate screenshot frame # Frame captured screenshots with device bezels ascelerate screenshot doctor # Check config and environment for problems ``` #### Config (`ascelerate/screenshot.yml`) ```yaml project: MyApp.xcodeproj scheme: AppUITests devices: - simulator: iPhone 17 Pro Max # frameDevice: true # deviceBezel: ./bezels/iPhone 17 Pro Max.png - simulator: iPad Pro 13-inch (M5) # frameDevice: true # deviceBezel: ./bezels/iPad Pro 13-inch (M5).png languages: [en-US, de-DE] outputDirectory: ./screenshots clearPreviousScreenshots: true localizeSimulator: true overrideStatusBar: true # helperPath: AppUITests/ScreenshotHelper.swift # testWithoutBuilding: true # headless: true # darkMode: false # disableAnimations: true # waitAfterBoot: 5 # waitAfterEraseAndReboot: 30 # extra wait for first-run system alerts (Apple Intelligence etc.); fires on first language and on retries # configuration: Debug # testplan: MyTestPlan # numberOfRetries: 1 # stopAfterFirstError: false # reinstallApp: false # xcargs: SWIFT_ACTIVE_COMPILATION_CONDITIONS=SCREENSHOTS # framedOutputDirectory: ./screenshots/framed ``` Supports dark mode capture, animation disabling, automatic retries (erases simulator, re-localizes, reboots), custom test plans, Xcode build configurations, and arbitrary xcodebuild arguments. #### Device framing Frame screenshots with Apple device bezels (from [Apple Design Resources](https://developer.apple.com/design/resources/)). Per-device: set `frameDevice: true` and `deviceBezel` path to the bezel PNG. Framing runs automatically after capture, or standalone via `screenshot frame`. Output goes to `framedOutputDirectory` (defaults to `{outputDirectory}/framed`). Use `screenshot doctor` to validate config, simulators, bezels, and environment. #### UITest usage ```swift override func setUp() { setupScreenshots(app) app.launch() } func testScreenshots() { screenshot("01-home") app.buttons["Settings"].tap() screenshot("02-settings") } ``` Builds once, runs tests concurrently across devices per language. Output: `screenshots/{language}/{device}-{name}.png`. Errors skip and continue with summary table. ### Builds ```bash ascelerate builds archive # Auto-detects workspace/scheme ascelerate builds upload MyApp.ipa ascelerate builds await-processing # Wait for processing ascelerate builds list --bundle-id ``` ### TestFlight ```bash # Beta groups ascelerate testflight groups list ascelerate testflight groups info "External Testers" # details + testers + builds ascelerate testflight groups create --name "Friends" --public-link --public-link-limit 100 ascelerate testflight groups update "Friends" --public-link false ascelerate testflight groups add-build "Friends" --build 123 # omit --build for latest ascelerate testflight groups delete "Friends" # Recruitment criteria (device/OS filters for public links) ascelerate testflight groups criteria view "Friends" --options ascelerate testflight groups criteria set "Friends" --filter IPHONE:18.0 --filter IPAD:17.0:26 ascelerate testflight groups criteria clear "Friends" # Testers ascelerate testflight testers list [--group "Friends"] ascelerate testflight testers add --email t@example.com --group "Friends" ascelerate testflight testers remove t@example.com --group "Friends" # omit --group to remove from whole app ascelerate testflight testers invite t@example.com # re-send invitation email ascelerate testflight testers import --file testers.csv --group "Friends" # CSV: email[,first[,last]] # Builds & distribution ascelerate testflight builds # TestFlight states per build ascelerate testflight versions # pre-release version trains ascelerate testflight status [--build 123] # processing/internal/external/beta review ascelerate testflight expire --build 123 ascelerate testflight notify # notify testers of latest build ascelerate testflight auto-notify --enabled true # toggle automatic notification # Tester feedback ascelerate testflight feedback crashes list [--build 123] ascelerate testflight feedback crashes log [--output crash.log] ascelerate testflight feedback screenshots list ascelerate testflight feedback screenshots download [submission-id] [--output X.zip] # zip of screenshots + comment; picker if ID omitted ascelerate testflight feedback crashes|screenshots info # full device details + comment ascelerate testflight feedback crashes|screenshots delete # What to Test (per build, per locale) ascelerate testflight whats-new view ascelerate testflight whats-new set --text "Bug fixes" [--locale en-US] # all locales if omitted ascelerate testflight whats-new export --output notes.json ascelerate testflight whats-new import --file notes.json # Beta review (required for external testing) ascelerate testflight submit [--build 123] ascelerate testflight app-info view # beta description, feedback email per locale ascelerate testflight app-info update --locale en-US --feedback-email me@example.com ascelerate testflight review-info # contact + demo account; pass flags to update ascelerate testflight eula [--file eula.txt | --text "..."] # --text "" reverts to Apple's standard ``` Build-scoped commands default to the latest non-expired build; pass `--build ` (and `--platform` for universal-purchase apps) to target a specific one. What to Test JSON format: `{"en-US": {"whatsNew": "..."}}`. ### Provisioning All provisioning commands support interactive mode (run without arguments for guided prompts): ```bash # Devices ascelerate devices list ascelerate devices register # Certificates (auto-generates CSR) ascelerate certs create --type DISTRIBUTION ascelerate certs revoke # Bundle IDs & capabilities ascelerate bundle-ids register --name "My App" --identifier com.example.MyApp --platform IOS ascelerate bundle-ids enable-capability com.example.MyApp --type PUSH_NOTIFICATIONS # Profiles ascelerate profiles create --name "My Profile" --type IOS_APP_STORE --bundle-id com.example.MyApp --certificates all ascelerate profiles reissue --all-invalid ``` Note: provisioning commands (devices, certs, bundle-ids, profiles) do NOT support aliases. ### App configuration ```bash ascelerate apps app-info view ascelerate apps app-info update --primary-category UTILITIES ascelerate apps app-info age-rating ascelerate apps app-info age-rating export ascelerate apps app-info age-rating import --file age-rating.json ascelerate apps availability --add CHN,RUS ascelerate apps encryption --create --description "Uses HTTPS" ascelerate apps eula --file eula.txt ascelerate apps phased-release --enable # App-level subscription grace period (after failed renewal payments) ascelerate apps subscription-grace-period # view ascelerate apps subscription-grace-period --opt-in true --duration SIXTEEN_DAYS --renewal-type ALL_RENEWALS ascelerate apps subscription-grace-period --sandbox-opt-in true ``` Grace period durations: `THREE_DAYS`, `SIXTEEN_DAYS`, `TWENTY_EIGHT_DAYS`. Renewal types: `ALL_RENEWALS`, `PAID_TO_PAID_ONLY`. ### Workflow files Automate multi-step releases with a plain text file: ``` # release.workflow apps create-version com.example.MyApp 2.1.0 builds archive --scheme MyApp builds upload --latest --bundle-id com.example.MyApp builds await-processing com.example.MyApp apps localizations import com.example.MyApp --file localizations.json apps build attach-latest com.example.MyApp apps review preflight com.example.MyApp apps review submit com.example.MyApp ``` ```bash ascelerate run-workflow release.workflow ascelerate run-workflow release.workflow --yes # Skip all prompts (CI/CD) ``` Commands are one per line, without the `ascelerate` prefix. Lines starting with `#` are comments. `builds upload` automatically passes the build version to subsequent commands. ## Adding a new language to an app When the user asks to add a new language/locale to an app, translate **all** of these: 1. **App info localizations** (name, subtitle, privacy URLs) — always 2. **Version localizations** (description, what's new, keywords, promo text) — always 3. **In-app purchases** — ask the user: translate all IAPs, or specific ones? 4. **Subscription groups** — ask the user: translate all groups, or specific ones? 5. **Subscriptions** — ask the user: translate all subscriptions, or specific ones? ### Workflow 1. Export existing localizations to see the source text: ```bash ascelerate apps app-info export ascelerate apps localizations export ascelerate iap localizations view # for each IAP ascelerate sub group-localizations export ascelerate sub localizations export # for each subscription ``` 2. Ask the user which IAPs, subscription groups, and subscriptions to translate (or all). 3. Translate the source text into the new locale. 4. Import the translations (use `-y` to skip confirmation prompts): ```bash ascelerate apps app-info import --file app-infos.json -y ascelerate apps localizations import --file localizations.json -y ascelerate iap localizations import --file iap.json -y ascelerate sub group-localizations import --file group.json -y ascelerate sub localizations import --file sub.json -y ``` ## Tips - Add `--yes` / `-y` to skip confirmation prompts (for scripting/CI) - Add `--json` to read commands for machine-readable output (see JSON output above) - Use `ascelerate rate-limit` to check API quota (3600 requests/hour) - Run `ascelerate install-completions` after updates for tab completion - Only editable versions (Prepare for Submission / Waiting for Review) accept updates - `promotionalText` can be updated on any version state - Export JSON → edit → import is the fastest way to update localizations across locales