apple ppo status | create --variant b[,c] | upload --variant b | start | stop: v2 experiments (platform IOS, traffic proportion), one treatment per shots variant (max 3), a treatment localization per App Store locale, and the variant renders synced into the treatment screenshot sets (shared MD5-idempotent set sync with apple screenshots, which no longer creates sets on --dry). start / stop ask first and are not MCP tools; MCP: apple_ppo_status, apple_ppo_create, apple_ppo_upload. Play experiments stay console-only (documented). apple.iphoneMedium (off by default): iphone-medium size key, 1206 x 2622 (1179 x 2556 accepted), uploaded as APP_IPHONE_61; rendered, checked, required and uploaded only when enabled. Apple's scaling rule documented in the config and the store-screenshots skill.
84 lines
7.5 KiB
TypeScript
Executable file
84 lines
7.5 KiB
TypeScript
Executable file
#!/usr/bin/env bun
|
|
// storebound: ship a mobile game to Google Play and the App Store from the terminal.
|
|
// Run `storebound help` for the command list. Config: storebound.config.ts; credentials: env or .storebound/.
|
|
import { parseArgs } from './lib/args';
|
|
import { loadConfig } from './lib/config';
|
|
import type { Ctx } from './lib/ctx';
|
|
|
|
type Mod = { run(ctx: Ctx): Promise<void> };
|
|
type Plain = { run(args: ReturnType<typeof parseArgs>): Promise<void> };
|
|
/** Commands that work without a storebound.config.ts. */
|
|
const PLAIN: Record<string, [() => Promise<Plain>, string]> = {
|
|
'init': [() => import('./init'), 'copy the templates (config, listing, copy, privacy policy) into this project'],
|
|
'install': [() => import('./install'), 'skills + MCP server for --agent claude|codex|cursor|copilot|windsurf|gemini|opencode'],
|
|
'mcp': [async () => ({ run: async () => (await import('./mcp')).serve() }), 'stdio MCP server wrapping these commands (for any MCP-capable AI tool)'],
|
|
'privacy-manifest': [() => import('./privacy-manifest'), 'iOS PrivacyInfo.xcprivacy + required-reason API + SDK manifest scan (--ios <path>)'],
|
|
};
|
|
const COMMANDS: Record<string, [() => Promise<Mod>, string]> = {
|
|
'check': [() => import('./check'), 'validate config, copy files, data safety answers and products (offline); --aso keyword audit'],
|
|
'validate': [() => import('./validate'), 'read-only store readiness report with ordered blockers (--apple / --play), plus local renders checks (--no-local skips); exit 1 on blockers'],
|
|
'analytics': [() => import('./analytics'), 'setup (App Store report request) | snapshot (impressions, page views, installs, conversion -> .storebound/analytics) | compare (vs listing changes in git)'],
|
|
'health': [() => import('./health'), 'crash / ANR vitals (Play) and diagnostics (App Store), read-only; --weekly writes a markdown report; exit 1 over a threshold'],
|
|
'prices': [() => import('./prices'), 'export | import a CSV of product x store x region prices (diff first, asks before writing; Apple future-dated changes)'],
|
|
'reviews': [() => import('./reviews'), 'list | draft (local reply drafts in .storebound/replies) | send (approved drafts only, asks first)'],
|
|
'whats-new': [() => import('./whats-new'), 'draft player-facing release notes from git log into the listing files (--since <tag>)'],
|
|
'play products': [() => import('./play/products'), 'one-time products: create / update, regional prices, activate'],
|
|
'play listing': [() => import('./play/listing'), 'app details + title / short / full description per language'],
|
|
'play images': [() => import('./play/images'), 'icon, feature graphic, phone / 7" / 10" screenshots per language; --variant <id>'],
|
|
'play data-safety': [() => import('./play/data-safety'), 'Data safety form (CSV import through the API)'],
|
|
'play release': [() => import('./play/release'), 'upload an AAB and put it on tracks with release notes'],
|
|
'play status': [() => import('./play/status'), 'tracks, listings, products (read-only)'],
|
|
'play rollout': [() => import('./play/rollout'), 'staged rollout: --fraction x | --halt | --resume | --complete (asks first)'],
|
|
'play next-version-code': [() => import('./play/next-version-code'), 'next free versionCode (prints the number)'],
|
|
'apple bundle': [() => import('./apple/bundle'), 'register the bundle id; finds the app record'],
|
|
'apple iap': [() => import('./apple/iap'), 'in-app purchases, localizations, price schedules, availability'],
|
|
'apple iap-review': [() => import('./apple/iap-review'), 'IAP review screenshots + product states'],
|
|
'apple listing': [() => import('./apple/listing'), 'version, build, name / subtitle / description / keywords per locale'],
|
|
'apple screenshots': [() => import('./apple/screenshots'), '6.9" + 6.5" (+ 13" iPad) screenshots per locale; --variant <id>'],
|
|
'apple appinfo': [() => import('./apple/appinfo'), 'categories, age rating, content rights, Free price, territories'],
|
|
'apple review-details': [() => import('./apple/review-details'), 'App Review contact + notes'],
|
|
'apple status': [() => import('./apple/status'), 'versions, builds, IAPs, review submissions (--wait-review, --cancel-submission <id>)'],
|
|
'apple previews': [() => import('./apple/previews'), 'app preview videos per locale (MD5-idempotent, poster frame time code); --dry'],
|
|
'apple release': [() => import('./apple/release'), 'phased release on|pause|resume|complete, --manual-release (asks first)'],
|
|
'apple next-build': [() => import('./apple/next-build'), 'next safe build number (prints the number)'],
|
|
'apple encryption': [() => import('./apple/encryption'), 'export compliance answer for builds, from the config'],
|
|
'apple ppo': [() => import('./apple/ppo'), 'Product Page Optimization: status | create --variant b | upload --variant b | start | stop (asks first)'],
|
|
'apple testflight': [() => import('./apple/testflight'), 'TestFlight: status | groups | testers (CSV in .storebound/) | what-to-test --build N | info | distribute --build N --group g [--submit-review]'],
|
|
'icons': [() => import('./icons'), 'App Store / Play / web / adaptive / legacy launcher icons from one artwork'],
|
|
'shots capture': [() => import('./shots/capture'), 'raw frames: --source web (playwright) | ios-sim (simctl) | android-emu (adb) | folder; --dry'],
|
|
'shots fonts': [() => import('./shots/fonts'), 'download font subsets for the copy (CJK / Arabic / Cyrillic ...)'],
|
|
'shots render': [() => import('./shots/render'), 'store screenshots + feature graphic in every size and language'],
|
|
'shots jpeg': [() => import('./shots/jpeg'), 'JPEG q92 copies of the Play renders (4x faster uploads)'],
|
|
'shots check': [() => import('./shots/check'), 'local store checks of the renders (size, alpha, counts, overflow) and folder frames; --variants, --json'],
|
|
'shots record': [() => import('./shots/record'), 'gameplay clips for app previews: --source web (playwright video) | ios-sim (simctl recordVideo) | android-emu (screenrecord) | folder; --dry'],
|
|
'shots video': [() => import('./shots/video'), 'App Store app previews (886x1920, 1200x1600) + YouTube promo video from the clips, captions, poster, store checks; --dry'],
|
|
'shots gallery': [() => import('./shots/gallery'), 'review page <renders>/index.html: every language, size, scene and variant, issues highlighted'],
|
|
};
|
|
|
|
function help(): void {
|
|
console.log(`storebound · ship mobile games to Google Play and the App Store
|
|
|
|
usage: storebound <command> [options]
|
|
|
|
${Object.entries(PLAIN).map(([k, [, d]]) => ` ${k.padEnd(25)} ${d}`).join('\n')}
|
|
${Object.entries(COMMANDS).map(([k, [, d]]) => ` ${k.padEnd(25)} ${d}`).join('\n')}
|
|
|
|
common options: --config <path> --dry (no writes) --only <ids> --yes (skip confirmations)
|
|
credentials: PLAY_SERVICE_ACCOUNT, ASC_KEY_ID, ASC_ISSUER_ID, ASC_P8 (env or .storebound/credentials.json)
|
|
docs: README.md and the skills/ folder of the toolchain`);
|
|
}
|
|
|
|
async function main(): Promise<void> {
|
|
const argv = process.argv.slice(2);
|
|
const [a, b] = argv;
|
|
if (!a || a === 'help' || a === '--help' || a === '-h') return help();
|
|
if (a === 'version' || a === '--version') return console.log((await import('../package.json')).version);
|
|
if (PLAIN[a]) return (await PLAIN[a]![0]()).run(parseArgs(argv.slice(1)));
|
|
const key = COMMANDS[`${a} ${b}`] ? `${a} ${b}` : COMMANDS[a] ? a : '';
|
|
if (!key) { console.error(`unknown command: ${argv.slice(0, 2).join(' ')}\n`); help(); process.exit(2); }
|
|
const args = parseArgs(argv.slice(key.split(' ').length));
|
|
const loaded = await loadConfig(args.get('config'));
|
|
await (await COMMANDS[key]![0]()).run({ loaded, args });
|
|
}
|
|
|
|
main().catch(e => { console.error(`\nerror: ${(e as Error).message}`); process.exit(1); });
|