Rename to storebound (plugin, CLI, config file, credentials folder, repo)
This commit is contained in:
parent
3cd31b7601
commit
11c45efab8
52 changed files with 171 additions and 171 deletions
|
|
@ -4,9 +4,9 @@
|
||||||
"owner": { "name": "CRTkafa" },
|
"owner": { "name": "CRTkafa" },
|
||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
"name": "crt-ship",
|
"name": "storebound",
|
||||||
"source": ".",
|
"source": ".",
|
||||||
"description": "Ship mobile games to Google Play and the App Store: skills for every store step plus the crt-ship CLI.",
|
"description": "Ship mobile games to Google Play and the App Store: skills for every store step plus the storebound CLI.",
|
||||||
"version": "0.1.0",
|
"version": "0.1.0",
|
||||||
"category": "development",
|
"category": "development",
|
||||||
"tags": ["mobile", "google-play", "app-store", "release"]
|
"tags": ["mobile", "google-play", "app-store", "release"]
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
{
|
{
|
||||||
"name": "crt-ship",
|
"name": "storebound",
|
||||||
"version": "0.1.0",
|
"version": "0.1.0",
|
||||||
"description": "Ship mobile games to Google Play and the App Store: store listings, in-app products, data safety, screenshots, icons and first-release checklists, as skills plus a Bun CLI (crt-ship). CRTkafa's own toolchain, open-sourced.",
|
"description": "Ship mobile games to Google Play and the App Store: store listings, in-app products, data safety, screenshots, icons and first-release checklists, as skills plus a Bun CLI (storebound). CRTkafa's own toolchain, open-sourced.",
|
||||||
"author": { "name": "CRTkafa" },
|
"author": { "name": "CRTkafa" },
|
||||||
"homepage": "https://git.crt.fyi/CRT/crt-ship",
|
"homepage": "https://git.crt.fyi/CRT/storebound",
|
||||||
"repository": "https://git.crt.fyi/CRT/crt-ship.git",
|
"repository": "https://git.crt.fyi/CRT/storebound.git",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"keywords": ["google-play", "app-store", "app-store-connect", "mobile-games", "iap", "screenshots", "app-icons", "release"]
|
"keywords": ["google-play", "app-store", "app-store-connect", "mobile-games", "iap", "screenshots", "app-icons", "release"]
|
||||||
}
|
}
|
||||||
|
|
|
||||||
2
.gitignore
vendored
2
.gitignore
vendored
|
|
@ -1,5 +1,5 @@
|
||||||
node_modules/
|
node_modules/
|
||||||
.crt-ship/
|
.storebound/
|
||||||
*.p8
|
*.p8
|
||||||
*service-account*.json
|
*service-account*.json
|
||||||
*.keystore
|
*.keystore
|
||||||
|
|
|
||||||
|
|
@ -4,10 +4,10 @@
|
||||||
|
|
||||||
First public cut, extracted from the scripts I used to ship my own game.
|
First public cut, extracted from the scripts I used to ship my own game.
|
||||||
|
|
||||||
- `crt-ship` CLI: `init`, `check`; Play `products`, `listing`, `images`, `data-safety`, `release`, `status`;
|
- `storebound` CLI: `init`, `check`; Play `products`, `listing`, `images`, `data-safety`, `release`, `status`;
|
||||||
App Store `bundle`, `iap`, `iap-review`, `listing`, `screenshots`, `appinfo`, `review-details`, `status`
|
App Store `bundle`, `iap`, `iap-review`, `listing`, `screenshots`, `appinfo`, `review-details`, `status`
|
||||||
(incl. canceling a review submission); `icons`; `shots capture | fonts | render | jpeg`.
|
(incl. canceling a review submission); `icons`; `shots capture | fonts | render | jpeg`.
|
||||||
- Per-project `crt-ship.config.ts`; credentials only from env or `.crt-ship/credentials.json`.
|
- Per-project `storebound.config.ts`; credentials only from env or `.storebound/credentials.json`.
|
||||||
- Claude Code plugin + marketplace with 8 skills: play-first-release, appstore-first-release, store-iap-setup,
|
- Claude Code plugin + marketplace with 8 skills: play-first-release, appstore-first-release, store-iap-setup,
|
||||||
store-screenshots, app-icons, store-declarations, privacy-policy, ads-levelplay-checks.
|
store-screenshots, app-icons, store-declarations, privacy-policy, ads-levelplay-checks.
|
||||||
- Templates: config, Play + App Store listing copy, screenshot copy (5 languages incl. Arabic + Japanese), Data
|
- Templates: config, Play + App Store listing copy, screenshot copy (5 languages incl. Arabic + Japanese), Data
|
||||||
|
|
|
||||||
30
README.md
30
README.md
|
|
@ -1,4 +1,4 @@
|
||||||
# crt-ship
|
# storebound
|
||||||
|
|
||||||
Hey. This is my toolchain for shipping mobile games to Google Play and the App Store. I built it while getting my
|
Hey. This is my toolchain for shipping mobile games to Google Play and the App Store. I built it while getting my
|
||||||
own game through both stores, hit every wall on the way (draft apps, edits that die when you touch the Console,
|
own game through both stores, hit every wall on the way (draft apps, edits that die when you touch the Console,
|
||||||
|
|
@ -12,7 +12,7 @@ plus Claude Code skills that walk you (or Claude) through the parts that are sti
|
||||||
|
|
||||||
## What is in the box
|
## What is in the box
|
||||||
|
|
||||||
- **`crt-ship` CLI** (Bun + TypeScript, zero runtime dependencies): store listings, in-app products with regional
|
- **`storebound` CLI** (Bun + TypeScript, zero runtime dependencies): store listings, in-app products with regional
|
||||||
prices, Play Data safety, AAB releases, App Store versions / screenshots / age rating / review details, icons from
|
prices, Play Data safety, AAB releases, App Store versions / screenshots / age rating / review details, icons from
|
||||||
one artwork, and a screenshot renderer (captioned scenes, device frames, 14+ languages incl. RTL and CJK).
|
one artwork, and a screenshot renderer (captioned scenes, device frames, 14+ languages incl. RTL and CJK).
|
||||||
- **Claude Code skills**: ordered steps for each job, which steps are API and which are UI-only (with the exact
|
- **Claude Code skills**: ordered steps for each job, which steps are API and which are UI-only (with the exact
|
||||||
|
|
@ -22,18 +22,18 @@ plus Claude Code skills that walk you (or Claude) through the parts that are sti
|
||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
As a Claude Code plugin (skills + the `crt-ship` command on Claude's PATH):
|
As a Claude Code plugin (skills + the `storebound` command on Claude's PATH):
|
||||||
|
|
||||||
```
|
```
|
||||||
/plugin marketplace add https://git.crt.fyi/CRT/crt-ship.git
|
/plugin marketplace add https://git.crt.fyi/CRT/storebound.git
|
||||||
/plugin install crt-ship@crtkafa
|
/plugin install storebound@crtkafa
|
||||||
```
|
```
|
||||||
|
|
||||||
As a CLI in your game repo (needs [Bun](https://bun.sh) 1.1+):
|
As a CLI in your game repo (needs [Bun](https://bun.sh) 1.1+):
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
bun add -d git+https://git.crt.fyi/CRT/crt-ship.git
|
bun add -d git+https://git.crt.fyi/CRT/storebound.git
|
||||||
bunx crt-ship help
|
bunx storebound help
|
||||||
```
|
```
|
||||||
|
|
||||||
Extra tools some commands use: `ffmpeg` (icons, screenshots), `cwebp` (optional), `playwright` in your project for
|
Extra tools some commands use: `ffmpeg` (icons, screenshots), `cwebp` (optional), `playwright` in your project for
|
||||||
|
|
@ -42,11 +42,11 @@ screenshots (`bun add -d playwright`; it uses Playwright's Chromium or your inst
|
||||||
## Quick start
|
## Quick start
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
bunx crt-ship init # crt-ship.config.ts, store/*.md, store/shots/copy.json, privacy policy, .crt-ship/ (gitignored)
|
bunx storebound init # storebound.config.ts, store/*.md, store/shots/copy.json, privacy policy, .storebound/ (gitignored)
|
||||||
# edit crt-ship.config.ts and the store/ files
|
# edit storebound.config.ts and the store/ files
|
||||||
bunx crt-ship check # offline: config, copy limits, data safety, files
|
bunx storebound check # offline: config, copy limits, data safety, files
|
||||||
bunx crt-ship play listing --dry
|
bunx storebound play listing --dry
|
||||||
bunx crt-ship apple iap --dry
|
bunx storebound apple iap --dry
|
||||||
```
|
```
|
||||||
|
|
||||||
Or just ask Claude: "ship my game to Google Play" / "set up the in-app purchases on both stores" / "make store
|
Or just ask Claude: "ship my game to Google Play" / "set up the in-app purchases on both stores" / "make store
|
||||||
|
|
@ -54,7 +54,7 @@ screenshots in 5 languages", and the matching skill kicks in.
|
||||||
|
|
||||||
## Credentials (never in the repo)
|
## Credentials (never in the repo)
|
||||||
|
|
||||||
Read from environment variables, or from `.crt-ship/credentials.json` in your project (gitignored by `init`):
|
Read from environment variables, or from `.storebound/credentials.json` in your project (gitignored by `init`):
|
||||||
|
|
||||||
| name | what |
|
| name | what |
|
||||||
|---|---|
|
|---|---|
|
||||||
|
|
@ -66,11 +66,11 @@ Read from environment variables, or from `.crt-ship/credentials.json` in your pr
|
||||||
## Commands
|
## Commands
|
||||||
|
|
||||||
Every write command takes `--dry`; re-runs are idempotent; output is one timestamped line per step, so long uploads
|
Every write command takes `--dry`; re-runs are idempotent; output is one timestamped line per step, so long uploads
|
||||||
can run in the background with a log (`crt-ship play images > .crt-ship/images.log 2>&1 &`).
|
can run in the background with a log (`storebound play images > .storebound/images.log 2>&1 &`).
|
||||||
|
|
||||||
| command | API / local | what |
|
| command | API / local | what |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `init` | local | copy the templates, gitignore `.crt-ship/` |
|
| `init` | local | copy the templates, gitignore `.storebound/` |
|
||||||
| `check` | local | validate config, copy limits, data safety, products, files |
|
| `check` | local | validate config, copy limits, data safety, products, files |
|
||||||
| `play products` | API | one-time products via `monetization.onetimeproducts`: regional prices from `convertRegionPrices` + your overrides, activate |
|
| `play products` | API | one-time products via `monetization.onetimeproducts`: regional prices from `convertRegionPrices` + your overrides, activate |
|
||||||
| `play listing` | API | app details + title / short / full description per language |
|
| `play listing` | API | app details + title / short / full description per language |
|
||||||
|
|
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
#!/bin/sh
|
|
||||||
# crt-ship launcher. On PATH while the Claude Code plugin is enabled; or symlink it anywhere.
|
|
||||||
here=$(cd "$(dirname "$0")" && pwd -P)
|
|
||||||
exec bun "$here/../cli/index.ts" "$@"
|
|
||||||
4
bin/storebound
Executable file
4
bin/storebound
Executable file
|
|
@ -0,0 +1,4 @@
|
||||||
|
#!/bin/sh
|
||||||
|
# storebound launcher. On PATH while the Claude Code plugin is enabled; or symlink it anywhere.
|
||||||
|
here=$(cd "$(dirname "$0")" && pwd -P)
|
||||||
|
exec bun "$here/../cli/index.ts" "$@"
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// App-level App Store settings (idempotent), from apple.info in crt-ship.config.ts:
|
// App-level App Store settings (idempotent), from apple.info in storebound.config.ts:
|
||||||
// crt-ship apple appinfo [--dry]
|
// storebound apple appinfo [--dry]
|
||||||
// - categories (primary + up to two game subcategories, secondary)
|
// - categories (primary + up to two game subcategories, secondary)
|
||||||
// - age rating declaration: every content question NONE / false unless overridden in apple.info.ageRating
|
// - age rating declaration: every content question NONE / false unless overridden in apple.info.ageRating
|
||||||
// - content rights declaration
|
// - content rights declaration
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Register the bundle id (Certificates, Identifiers & Profiles) through the API. Idempotent.
|
// Register the bundle id (Certificates, Identifiers & Profiles) through the API. Idempotent.
|
||||||
// crt-ship apple bundle [--name "My Game"] [--dry]
|
// storebound apple bundle [--name "My Game"] [--dry]
|
||||||
// The App Store Connect app record itself can NOT be created through the API: do that in the web UI afterwards
|
// The App Store Connect app record itself can NOT be created through the API: do that in the web UI afterwards
|
||||||
// (Apps > + > New App, pick this bundle id), see the appstore-first-release skill.
|
// (Apps > + > New App, pick this bundle id), see the appstore-first-release skill.
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// Upload the App Review screenshot of every in-app purchase (idempotent: a screenshot whose MD5 matches is kept) and
|
// Upload the App Review screenshot of every in-app purchase (idempotent: a screenshot whose MD5 matches is kept) and
|
||||||
// print each product's state. Nothing is submitted.
|
// print each product's state. Nothing is submitted.
|
||||||
// crt-ship apple iap-review [--dry]
|
// storebound apple iap-review [--dry]
|
||||||
// Screenshot per product: products[].reviewScreenshot, else apple.reviewShots/<product id>.(png|jpg).
|
// Screenshot per product: products[].reviewScreenshot, else apple.reviewShots/<product id>.(png|jpg).
|
||||||
// Size: a real device screenshot size (e.g. 1290 x 2796); other sizes fail with IMAGE_INCORRECT_DIMENSIONS.
|
// Size: a real device screenshot size (e.g. 1290 x 2796); other sizes fail with IMAGE_INCORRECT_DIMENSIONS.
|
||||||
import { existsSync, readFileSync } from 'node:fs';
|
import { existsSync, readFileSync } from 'node:fs';
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
// In-app purchases on App Store Connect: create missing products, localizations, price schedule (USA base + your
|
// In-app purchases on App Store Connect: create missing products, localizations, price schedule (USA base + your
|
||||||
// overrides; Apple equalizes every other storefront) and availability (every territory + new ones). Idempotent:
|
// overrides; Apple equalizes every other storefront) and availability (every territory + new ones). Idempotent:
|
||||||
// existing products and schedules are left alone (prices of an existing schedule are not changed; do that in the UI).
|
// existing products and schedules are left alone (prices of an existing schedule are not changed; do that in the UI).
|
||||||
// crt-ship apple iap [--dry] [--only id1,id2]
|
// storebound apple iap [--dry] [--only id1,id2]
|
||||||
// Then `apple iap-review` for the review screenshots. First IAPs can only be submitted together with an app version,
|
// Then `apple iap-review` for the review screenshots. First IAPs can only be submitted together with an app version,
|
||||||
// from the IAP page in the web UI (see the store-iap-setup skill).
|
// from the IAP page in the web UI (see the store-iap-setup skill).
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// App Store version + listing text (idempotent; re-run after editing the App Store listing file).
|
// App Store version + listing text (idempotent; re-run after editing the App Store listing file).
|
||||||
// crt-ship apple listing --version 1.0.0 [--build 3] [--dry]
|
// storebound apple listing --version 1.0.0 [--build 3] [--dry]
|
||||||
// - the editable iOS version: versionString, copyright, release type MANUAL; with --build that processed build is attached
|
// - the editable iOS version: versionString, copyright, release type MANUAL; with --build that processed build is attached
|
||||||
// - appInfoLocalizations: name, subtitle, privacy policy URL per locale
|
// - appInfoLocalizations: name, subtitle, privacy policy URL per locale
|
||||||
// - appStoreVersionLocalizations: description, keywords, promotional text, what's new (not on a first version),
|
// - appStoreVersionLocalizations: description, keywords, promotional text, what's new (not on a first version),
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
// App Review information on the editable version: contact, demo account (none), notes. Idempotent.
|
// App Review information on the editable version: contact, demo account (none), notes. Idempotent.
|
||||||
// crt-ship apple review-details [--contact-from <Apple ID of another app>] [--dry]
|
// storebound apple review-details [--contact-from <Apple ID of another app>] [--dry]
|
||||||
// The contact (name, phone, email) is personal data, so it is never in the config: it comes from
|
// The contact (name, phone, email) is personal data, so it is never in the config: it comes from
|
||||||
// .crt-ship/credentials.json "reviewContact", or is copied from another app of the same team with --contact-from.
|
// .storebound/credentials.json "reviewContact", or is copied from another app of the same team with --contact-from.
|
||||||
// Notes: apple.info.reviewNotes in crt-ship.config.ts.
|
// Notes: apple.info.reviewNotes in storebound.config.ts.
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
import { need } from '../lib/ctx';
|
import { need } from '../lib/ctx';
|
||||||
import { reviewContact } from '../lib/credentials';
|
import { reviewContact } from '../lib/credentials';
|
||||||
|
|
@ -27,7 +27,7 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const rc = reviewContact(root);
|
const rc = reviewContact(root);
|
||||||
if (rc) contact = { contactFirstName: rc.firstName, contactLastName: rc.lastName, contactPhone: rc.phone, contactEmail: rc.email };
|
if (rc) contact = { contactFirstName: rc.firstName, contactLastName: rc.lastName, contactPhone: rc.phone, contactEmail: rc.email };
|
||||||
}
|
}
|
||||||
if (!contact) throw new Error('no review contact: add "reviewContact" to .crt-ship/credentials.json or pass --contact-from <app id>');
|
if (!contact) throw new Error('no review contact: add "reviewContact" to .storebound/credentials.json or pass --contact-from <app id>');
|
||||||
|
|
||||||
const attributes = { ...contact, demoAccountRequired: false, demoAccountName: null, demoAccountPassword: null, notes: config.apple?.info?.reviewNotes ?? '' };
|
const attributes = { ...contact, demoAccountRequired: false, demoAccountName: null, demoAccountPassword: null, notes: config.apple?.info?.reviewNotes ?? '' };
|
||||||
if (ctx.args.has('dry')) { log('apple', `would set review details (contact ${from ? 'copied from ' + from : 'from credentials'}, notes ${attributes.notes.length} chars)`); return; }
|
if (ctx.args.has('dry')) { log('apple', `would set review details (contact ${from ? 'copied from ' + from : 'from credentials'}, notes ${attributes.notes.length} chars)`); return; }
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// Store screenshots of every locale on the editable App Store version (idempotent: a set whose files already match
|
// Store screenshots of every locale on the editable App Store version (idempotent: a set whose files already match
|
||||||
// by MD5 and order is left alone, otherwise it is emptied and re-uploaded).
|
// by MD5 and order is left alone, otherwise it is emptied and re-uploaded).
|
||||||
// crt-ship apple screenshots [--src store/renders] [--only en-US,tr] [--jobs 4]
|
// storebound apple screenshots [--src store/renders] [--only en-US,tr] [--jobs 4]
|
||||||
// Source per language: <renders>/<language id>/ios69/NN.png (6.9", 1320 x 2868 -> APP_IPHONE_67) and
|
// Source per language: <renders>/<language id>/ios69/NN.png (6.9", 1320 x 2868 -> APP_IPHONE_67) and
|
||||||
// ios65/NN.png (6.5", 1284 x 2778 -> APP_IPHONE_65). Up to 10 per set. Apple processes uploads asynchronously; failed
|
// ios65/NN.png (6.5", 1284 x 2778 -> APP_IPHONE_65). Up to 10 per set. Apple processes uploads asynchronously; failed
|
||||||
// ones are reported at the end. Long: run in the background with a log file.
|
// ones are reported at the end. Long: run in the background with a log file.
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
// Read-only overview: app record, versions + attached build, recent builds, in-app purchases, review submissions.
|
// Read-only overview: app record, versions + attached build, recent builds, in-app purchases, review submissions.
|
||||||
// crt-ship apple status [--json]
|
// storebound apple status [--json]
|
||||||
// And the one write it offers: cancel a review submission (to re-add first IAPs to it from the web UI):
|
// And the one write it offers: cancel a review submission (to re-add first IAPs to it from the web UI):
|
||||||
// crt-ship apple status --cancel-submission <id> [--yes]
|
// storebound apple status --cancel-submission <id> [--yes]
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
import { confirm, need } from '../lib/ctx';
|
import { confirm, need } from '../lib/ctx';
|
||||||
import { log } from '../lib/log';
|
import { log } from '../lib/log';
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// Offline sanity check of everything the store commands read: config, both listing files, the screenshot copy, data
|
// Offline sanity check of everything the store commands read: config, both listing files, the screenshot copy, data
|
||||||
// safety answers, product texts vs store limits, and the files the config points at. No network, no credentials.
|
// safety answers, product texts vs store limits, and the files the config points at. No network, no credentials.
|
||||||
// crt-ship check
|
// storebound check
|
||||||
import { existsSync, readFileSync } from 'node:fs';
|
import { existsSync, readFileSync } from 'node:fs';
|
||||||
import { playCodes } from './lib/config';
|
import { playCodes } from './lib/config';
|
||||||
import { len, parseAppStoreListing, parsePlayListing } from './lib/copy';
|
import { len, parseAppStoreListing, parsePlayListing } from './lib/copy';
|
||||||
|
|
@ -44,8 +44,8 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const files = [config.icons?.composite, config.icons?.foreground, config.icons?.background, config.shots?.logo,
|
const files = [config.icons?.composite, config.icons?.foreground, config.icons?.background, config.shots?.logo,
|
||||||
...(config.products ?? []).map(p => p.reviewScreenshot)].filter((f): f is string => !!f);
|
...(config.products ?? []).map(p => p.reviewScreenshot)].filter((f): f is string => !!f);
|
||||||
for (const f of new Set(files)) if (!existsSync(resolve(f))) problems.push(`missing file: ${f}`);
|
for (const f of new Set(files)) if (!existsSync(resolve(f))) problems.push(`missing file: ${f}`);
|
||||||
if (existsSync(resolve('.gitignore')) && !/^\/?\.crt-ship\/?$/m.test(readFileSync(resolve('.gitignore'), 'utf8')))
|
if (existsSync(resolve('.gitignore')) && !/^\/?\.storebound\/?$/m.test(readFileSync(resolve('.gitignore'), 'utf8')))
|
||||||
problems.push('.gitignore does not ignore .crt-ship/ (credentials live there)');
|
problems.push('.gitignore does not ignore .storebound/ (credentials live there)');
|
||||||
|
|
||||||
if (problems.length) { for (const p of problems) console.error(` - ${p}`); throw new Error(`${problems.length} problems`); }
|
if (problems.length) { for (const p of problems) console.error(` - ${p}`); throw new Error(`${problems.length} problems`); }
|
||||||
log('check', 'all good');
|
log('check', 'all good');
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// One artwork -> every icon the stores, the native shells and the web build need. Needs ffmpeg (cwebp optional).
|
// One artwork -> every icon the stores, the native shells and the web build need. Needs ffmpeg (cwebp optional).
|
||||||
// crt-ship icons [--dry]
|
// storebound icons [--dry]
|
||||||
// In (icons in crt-ship.config.ts): composite (1024 opaque full icon), foreground (1024 RGBA subject on transparent)
|
// In (icons in storebound.config.ts): composite (1024 opaque full icon), foreground (1024 RGBA subject on transparent)
|
||||||
// and background (1024 opaque) for the adaptive / maskable variants.
|
// and background (1024 opaque) for the adaptive / maskable variants.
|
||||||
// Out:
|
// Out:
|
||||||
// <out>/app-store-1024.png App Store icon, rgb24 (Apple rejects an alpha channel)
|
// <out>/app-store-1024.png App Store icon, rgb24 (Apple rejects an alpha channel)
|
||||||
|
|
@ -50,7 +50,7 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const fg = ic.foreground ? resolve(ic.foreground) : '';
|
const fg = ic.foreground ? resolve(ic.foreground) : '';
|
||||||
const bg = ic.background ? resolve(ic.background) : '';
|
const bg = ic.background ? resolve(ic.background) : '';
|
||||||
const adaptiveK = ic.adaptiveScale ?? ADAPTIVE_FG;
|
const adaptiveK = ic.adaptiveScale ?? ADAPTIVE_FG;
|
||||||
const tmp = join(root, '.crt-ship', 'tmp-icons');
|
const tmp = join(root, '.storebound', 'tmp-icons');
|
||||||
mkdirSync(tmp, { recursive: true });
|
mkdirSync(tmp, { recursive: true });
|
||||||
|
|
||||||
const opaque = (size: number, out: string, palette = false): void => {
|
const opaque = (size: number, out: string, palette = false): void => {
|
||||||
|
|
|
||||||
10
cli/index.ts
10
cli/index.ts
|
|
@ -1,6 +1,6 @@
|
||||||
#!/usr/bin/env bun
|
#!/usr/bin/env bun
|
||||||
// crt-ship: ship a mobile game to Google Play and the App Store from the terminal.
|
// storebound: ship a mobile game to Google Play and the App Store from the terminal.
|
||||||
// Run `crt-ship help` for the command list. Config: crt-ship.config.ts; credentials: env or .crt-ship/.
|
// Run `storebound help` for the command list. Config: storebound.config.ts; credentials: env or .storebound/.
|
||||||
import { parseArgs } from './lib/args';
|
import { parseArgs } from './lib/args';
|
||||||
import { loadConfig } from './lib/config';
|
import { loadConfig } from './lib/config';
|
||||||
import type { Ctx } from './lib/ctx';
|
import type { Ctx } from './lib/ctx';
|
||||||
|
|
@ -30,15 +30,15 @@ const COMMANDS: Record<string, [() => Promise<Mod>, string]> = {
|
||||||
};
|
};
|
||||||
|
|
||||||
function help(): void {
|
function help(): void {
|
||||||
console.log(`crt-ship · ship mobile games to Google Play and the App Store
|
console.log(`storebound · ship mobile games to Google Play and the App Store
|
||||||
|
|
||||||
usage: crt-ship <command> [options]
|
usage: storebound <command> [options]
|
||||||
|
|
||||||
init copy the templates (config, listing, copy, privacy policy) into this project
|
init copy the templates (config, listing, copy, privacy policy) into this project
|
||||||
${Object.entries(COMMANDS).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)
|
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 .crt-ship/credentials.json)
|
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`);
|
docs: README.md and the skills/ folder of the toolchain`);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
18
cli/init.ts
18
cli/init.ts
|
|
@ -1,5 +1,5 @@
|
||||||
// Copies the templates into the current project without overwriting anything, and makes sure .crt-ship/ is ignored.
|
// Copies the templates into the current project without overwriting anything, and makes sure .storebound/ is ignored.
|
||||||
// crt-ship init [--dir .]
|
// storebound init [--dir .]
|
||||||
import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
||||||
import { dirname, join, resolve } from 'node:path';
|
import { dirname, join, resolve } from 'node:path';
|
||||||
import type { Args } from './lib/args';
|
import type { Args } from './lib/args';
|
||||||
|
|
@ -7,14 +7,14 @@ import { log } from './lib/log';
|
||||||
|
|
||||||
const T = join(import.meta.dir, '..', 'templates');
|
const T = join(import.meta.dir, '..', 'templates');
|
||||||
const FILES: [string, string][] = [
|
const FILES: [string, string][] = [
|
||||||
['crt-ship.config.ts', 'crt-ship.config.ts'],
|
['storebound.config.ts', 'storebound.config.ts'],
|
||||||
['listing.md', 'store/listing.md'],
|
['listing.md', 'store/listing.md'],
|
||||||
['appstore.md', 'store/appstore.md'],
|
['appstore.md', 'store/appstore.md'],
|
||||||
['shots-copy.json', 'store/shots/copy.json'],
|
['shots-copy.json', 'store/shots/copy.json'],
|
||||||
['app-privacy.md', 'store/app-privacy.md'],
|
['app-privacy.md', 'store/app-privacy.md'],
|
||||||
['declarations.md', 'store/declarations.md'],
|
['declarations.md', 'store/declarations.md'],
|
||||||
['privacy-policy.html', 'store/privacy-policy.html'],
|
['privacy-policy.html', 'store/privacy-policy.html'],
|
||||||
['credentials.example.json', '.crt-ship/credentials.json'],
|
['credentials.example.json', '.storebound/credentials.json'],
|
||||||
];
|
];
|
||||||
|
|
||||||
export async function run(args: Args): Promise<void> {
|
export async function run(args: Args): Promise<void> {
|
||||||
|
|
@ -28,10 +28,10 @@ export async function run(args: Args): Promise<void> {
|
||||||
}
|
}
|
||||||
const gi = join(root, '.gitignore');
|
const gi = join(root, '.gitignore');
|
||||||
const cur = existsSync(gi) ? readFileSync(gi, 'utf8') : '';
|
const cur = existsSync(gi) ? readFileSync(gi, 'utf8') : '';
|
||||||
if (!/^\/?\.crt-ship\/?$/m.test(cur)) {
|
if (!/^\/?\.storebound\/?$/m.test(cur)) {
|
||||||
if (cur) appendFileSync(gi, `${cur.endsWith('\n') ? '' : '\n'}# crt-ship: credentials, fonts, temp files\n.crt-ship/\n`);
|
if (cur) appendFileSync(gi, `${cur.endsWith('\n') ? '' : '\n'}# storebound: credentials, fonts, temp files\n.storebound/\n`);
|
||||||
else writeFileSync(gi, '# crt-ship: credentials, fonts, temp files\n.crt-ship/\n');
|
else writeFileSync(gi, '# storebound: credentials, fonts, temp files\n.storebound/\n');
|
||||||
log('init', '.gitignore: added .crt-ship/');
|
log('init', '.gitignore: added .storebound/');
|
||||||
}
|
}
|
||||||
log('init', 'next: edit crt-ship.config.ts and .crt-ship/credentials.json, then `crt-ship check`');
|
log('init', 'next: edit storebound.config.ts and .storebound/credentials.json, then `storebound check`');
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
// Per-project config (crt-ship.config.ts at the project root). Everything game-specific lives here; credentials never
|
// Per-project config (storebound.config.ts at the project root). Everything game-specific lives here; credentials never
|
||||||
// do (see credentials.ts). The file default-exports a plain object; `import type { ShipConfig }` is optional.
|
// do (see credentials.ts). The file default-exports a plain object; `import type { ShipConfig }` is optional.
|
||||||
import { existsSync } from 'node:fs';
|
import { existsSync } from 'node:fs';
|
||||||
import { dirname, isAbsolute, join, resolve } from 'node:path';
|
import { dirname, isAbsolute, join, resolve } from 'node:path';
|
||||||
|
|
@ -227,9 +227,9 @@ export function validateConfig(c: unknown): string[] {
|
||||||
|
|
||||||
export interface Loaded { config: ShipConfig; root: string; path: string; resolve(p: string): string }
|
export interface Loaded { config: ShipConfig; root: string; path: string; resolve(p: string): string }
|
||||||
|
|
||||||
const NAMES = ['crt-ship.config.ts', 'crt-ship.config.js', 'crt-ship.config.json'];
|
const NAMES = ['storebound.config.ts', 'storebound.config.js', 'storebound.config.json'];
|
||||||
|
|
||||||
/** Finds crt-ship.config.* from `start` upwards (or uses `explicit`), imports and validates it. */
|
/** Finds storebound.config.* from `start` upwards (or uses `explicit`), imports and validates it. */
|
||||||
export async function loadConfig(explicit?: string, start = process.cwd()): Promise<Loaded> {
|
export async function loadConfig(explicit?: string, start = process.cwd()): Promise<Loaded> {
|
||||||
let path = explicit ? resolve(explicit) : '';
|
let path = explicit ? resolve(explicit) : '';
|
||||||
if (!path) {
|
if (!path) {
|
||||||
|
|
@ -239,7 +239,7 @@ export async function loadConfig(explicit?: string, start = process.cwd()): Prom
|
||||||
if (dirname(d) === d) break;
|
if (dirname(d) === d) break;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (!path || !existsSync(path)) throw new Error('no crt-ship.config.ts found (run `crt-ship init` or pass --config)');
|
if (!path || !existsSync(path)) throw new Error('no storebound.config.ts found (run `storebound init` or pass --config)');
|
||||||
const mod = await import(path);
|
const mod = await import(path);
|
||||||
const config = (mod.default ?? mod) as ShipConfig;
|
const config = (mod.default ?? mod) as ShipConfig;
|
||||||
const errors = validateConfig(config);
|
const errors = validateConfig(config);
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
// Credentials never live in crt-ship.config.ts or in git. Sources, first hit wins:
|
// Credentials never live in storebound.config.ts or in git. Sources, first hit wins:
|
||||||
// 1. environment: PLAY_SERVICE_ACCOUNT (path to the JSON key, or the JSON itself), ASC_KEY_ID, ASC_ISSUER_ID,
|
// 1. environment: PLAY_SERVICE_ACCOUNT (path to the JSON key, or the JSON itself), ASC_KEY_ID, ASC_ISSUER_ID,
|
||||||
// ASC_P8 (path to AuthKey_<id>.p8, or the PEM itself)
|
// ASC_P8 (path to AuthKey_<id>.p8, or the PEM itself)
|
||||||
// 2. <project>/.crt-ship/credentials.json (gitignored), same names:
|
// 2. <project>/.storebound/credentials.json (gitignored), same names:
|
||||||
// { "PLAY_SERVICE_ACCOUNT": "...", "ASC_KEY_ID": "...", "ASC_ISSUER_ID": "...", "ASC_P8": "...",
|
// { "PLAY_SERVICE_ACCOUNT": "...", "ASC_KEY_ID": "...", "ASC_ISSUER_ID": "...", "ASC_P8": "...",
|
||||||
// "reviewContact": { "firstName": "", "lastName": "", "phone": "", "email": "" } }
|
// "reviewContact": { "firstName": "", "lastName": "", "phone": "", "email": "" } }
|
||||||
// 3. ASC_P8 only: ~/.appstoreconnect/private_keys/AuthKey_<ASC_KEY_ID>.p8 (where Xcode / altool keep it)
|
// 3. ASC_P8 only: ~/.appstoreconnect/private_keys/AuthKey_<ASC_KEY_ID>.p8 (where Xcode / altool keep it)
|
||||||
|
|
@ -16,7 +16,7 @@ export interface ReviewContact { firstName: string; lastName: string; phone: str
|
||||||
type Store = Record<string, unknown>;
|
type Store = Record<string, unknown>;
|
||||||
|
|
||||||
function fileStore(root: string): Store {
|
function fileStore(root: string): Store {
|
||||||
const p = join(root, '.crt-ship', 'credentials.json');
|
const p = join(root, '.storebound', 'credentials.json');
|
||||||
if (!existsSync(p)) return {};
|
if (!existsSync(p)) return {};
|
||||||
try { return JSON.parse(readFileSync(p, 'utf8')) as Store; } catch (e) { throw new Error(`${p}: ${(e as Error).message}`); }
|
try { return JSON.parse(readFileSync(p, 'utf8')) as Store; } catch (e) { throw new Error(`${p}: ${(e as Error).message}`); }
|
||||||
}
|
}
|
||||||
|
|
@ -40,20 +40,20 @@ export function parseServiceAccount(text: string): ServiceAccount {
|
||||||
|
|
||||||
export function playServiceAccount(root: string): ServiceAccount {
|
export function playServiceAccount(root: string): ServiceAccount {
|
||||||
const v = value(root, 'PLAY_SERVICE_ACCOUNT');
|
const v = value(root, 'PLAY_SERVICE_ACCOUNT');
|
||||||
if (!v) throw new Error('PLAY_SERVICE_ACCOUNT is not set (env, or .crt-ship/credentials.json): path to the service account JSON key');
|
if (!v) throw new Error('PLAY_SERVICE_ACCOUNT is not set (env, or .storebound/credentials.json): path to the service account JSON key');
|
||||||
return parseServiceAccount(inline(v, /^\s*\{/));
|
return parseServiceAccount(inline(v, /^\s*\{/));
|
||||||
}
|
}
|
||||||
|
|
||||||
export function ascKey(root: string): AscKey {
|
export function ascKey(root: string): AscKey {
|
||||||
const keyId = value(root, 'ASC_KEY_ID');
|
const keyId = value(root, 'ASC_KEY_ID');
|
||||||
const issuerId = value(root, 'ASC_ISSUER_ID');
|
const issuerId = value(root, 'ASC_ISSUER_ID');
|
||||||
if (!keyId || !issuerId) throw new Error('ASC_KEY_ID and ASC_ISSUER_ID are not set (env, or .crt-ship/credentials.json)');
|
if (!keyId || !issuerId) throw new Error('ASC_KEY_ID and ASC_ISSUER_ID are not set (env, or .storebound/credentials.json)');
|
||||||
const p8 = value(root, 'ASC_P8') ?? join(homedir(), '.appstoreconnect/private_keys', `AuthKey_${keyId}.p8`);
|
const p8 = value(root, 'ASC_P8') ?? join(homedir(), '.appstoreconnect/private_keys', `AuthKey_${keyId}.p8`);
|
||||||
if (!/BEGIN PRIVATE KEY/.test(p8) && !existsSync(p8.replace(/^~(?=\/)/, homedir()))) throw new Error(`App Store Connect key not found: ${p8} (set ASC_P8)`);
|
if (!/BEGIN PRIVATE KEY/.test(p8) && !existsSync(p8.replace(/^~(?=\/)/, homedir()))) throw new Error(`App Store Connect key not found: ${p8} (set ASC_P8)`);
|
||||||
return { keyId, issuerId, pem: inline(p8, /BEGIN PRIVATE KEY/) };
|
return { keyId, issuerId, pem: inline(p8, /BEGIN PRIVATE KEY/) };
|
||||||
}
|
}
|
||||||
|
|
||||||
/** App Review contact from .crt-ship/credentials.json (personal data, so never in the config). */
|
/** App Review contact from .storebound/credentials.json (personal data, so never in the config). */
|
||||||
export function reviewContact(root: string): ReviewContact | null {
|
export function reviewContact(root: string): ReviewContact | null {
|
||||||
const c = fileStore(root).reviewContact as Partial<ReviewContact> | undefined;
|
const c = fileStore(root).reviewContact as Partial<ReviewContact> | undefined;
|
||||||
if (!c?.email) return null;
|
if (!c?.email) return null;
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@ import { playCodes } from './config';
|
||||||
export interface Ctx { loaded: Loaded; args: Args }
|
export interface Ctx { loaded: Loaded; args: Args }
|
||||||
|
|
||||||
export function need<T>(v: T | undefined, what: string): T {
|
export function need<T>(v: T | undefined, what: string): T {
|
||||||
if (v === undefined || v === null) throw new Error(`crt-ship.config.ts: ${what} is not set`);
|
if (v === undefined || v === null) throw new Error(`storebound.config.ts: ${what} is not set`);
|
||||||
return v;
|
return v;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Plain, line-based progress output: easy to follow live and easy to tail when a long upload runs in the background
|
// Plain, line-based progress output: easy to follow live and easy to tail when a long upload runs in the background
|
||||||
// (`crt-ship play images > .crt-ship/images.log 2>&1 &`). Every line carries a timestamp and a tag.
|
// (`storebound play images > .storebound/images.log 2>&1 &`). Every line carries a timestamp and a tag.
|
||||||
const t0 = Date.now();
|
const t0 = Date.now();
|
||||||
const stamp = (): string => new Date().toISOString().slice(11, 19);
|
const stamp = (): string => new Date().toISOString().slice(11, 19);
|
||||||
const since = (): string => `${((Date.now() - t0) / 1000).toFixed(0)}s`;
|
const since = (): string => `${((Date.now() - t0) / 1000).toFixed(0)}s`;
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// Play Data safety form through applications.dataSafety (CSV import; replaces every earlier answer).
|
// Play Data safety form through applications.dataSafety (CSV import; replaces every earlier answer).
|
||||||
// crt-ship play data-safety [--csv out.csv] [--dry]
|
// storebound play data-safety [--csv out.csv] [--dry]
|
||||||
// Answers come from `dataSafety` in crt-ship.config.ts. --dry only writes / prints the CSV.
|
// Answers come from `dataSafety` in storebound.config.ts. --dry only writes / prints the CSV.
|
||||||
import { writeFileSync } from 'node:fs';
|
import { writeFileSync } from 'node:fs';
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
import { need } from '../lib/ctx';
|
import { need } from '../lib/ctx';
|
||||||
|
|
|
||||||
|
|
@ -1,9 +1,9 @@
|
||||||
// Play store graphics per language, one edit per language (a Console save in parallel then only costs a retry of that
|
// Play store graphics per language, one edit per language (a Console save in parallel then only costs a retry of that
|
||||||
// language, not of the whole upload).
|
// language, not of the whole upload).
|
||||||
// crt-ship play images [--dry] [--only en-US,de-DE] [--src store/renders]
|
// storebound play images [--dry] [--only en-US,de-DE] [--src store/renders]
|
||||||
// Per Play language, from <renders>/<language id>/: icon (play.icon, 512x512), featureGraphic (feature/1024x500.*),
|
// Per Play language, from <renders>/<language id>/: icon (play.icon, 512x512), featureGraphic (feature/1024x500.*),
|
||||||
// phoneScreenshots (play/NN.*), sevenInchScreenshots (tab7/NN.*), tenInchScreenshots (tab10/NN.*). A .jpg next to a
|
// phoneScreenshots (play/NN.*), sevenInchScreenshots (tab7/NN.*), tenInchScreenshots (tab10/NN.*). A .jpg next to a
|
||||||
// .png wins (JPEG q92 uploads about 4x faster; `crt-ship shots jpeg` makes them). Each image type is cleared
|
// .png wins (JPEG q92 uploads about 4x faster; `storebound shots jpeg` makes them). Each image type is cleared
|
||||||
// before uploading, so re-runs are idempotent. Uploads are slow: run in the background with a log file.
|
// before uploading, so re-runs are idempotent. Uploads are slow: run in the background with a log file.
|
||||||
import { existsSync, readdirSync, readFileSync } from 'node:fs';
|
import { existsSync, readdirSync, readFileSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
|
|
@ -45,7 +45,7 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const set: [string, string[]][] = [['icon', [icon]], ['featureGraphic', feature ? [feature] : []],
|
const set: [string, string[]][] = [['icon', [icon]], ['featureGraphic', feature ? [feature] : []],
|
||||||
...Object.entries(PLAY_IMAGE_DIRS).map(([type, sub]) => [type, numberedImages(join(dir, sub)).slice(0, 8)] as [string, string[]])];
|
...Object.entries(PLAY_IMAGE_DIRS).map(([type, sub]) => [type, numberedImages(join(dir, sub)).slice(0, 8)] as [string, string[]])];
|
||||||
for (const [type, files] of set) {
|
for (const [type, files] of set) {
|
||||||
if (!files.length || !files.every(existsSync)) throw new Error(`${code}: no ${type} in ${dir} (render first: crt-ship shots render)`);
|
if (!files.length || !files.every(existsSync)) throw new Error(`${code}: no ${type} in ${dir} (render first: storebound shots render)`);
|
||||||
if (type.endsWith('Screenshots') && files.length < 2) throw new Error(`${code}: ${type} needs at least 2 images`);
|
if (type.endsWith('Screenshots') && files.length < 2) throw new Error(`${code}: ${type} needs at least 2 images`);
|
||||||
}
|
}
|
||||||
sets.set(code, set);
|
sets.set(code, set);
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Play store listing text + app details in one edit.
|
// Play store listing text + app details in one edit.
|
||||||
// crt-ship play listing [--dry] [--only en-US,de-DE]
|
// storebound play listing [--dry] [--only en-US,de-DE]
|
||||||
// App details: default language, contact email, website (must be the domain that serves app-ads.txt).
|
// App details: default language, contact email, website (must be the domain that serves app-ads.txt).
|
||||||
// Listings: title, short and full description of every `<!-- play: ... -->` section of the listing file.
|
// Listings: title, short and full description of every `<!-- play: ... -->` section of the listing file.
|
||||||
import { readFileSync } from 'node:fs';
|
import { readFileSync } from 'node:fs';
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// In-app products on Google Play through monetization.onetimeproducts (the legacy inappproducts API answers 403
|
// In-app products on Google Play through monetization.onetimeproducts (the legacy inappproducts API answers 403
|
||||||
// "Please migrate to the new publishing API" for apps on the new model).
|
// "Please migrate to the new publishing API" for apps on the new model).
|
||||||
// crt-ship play products [--dry] [--only id1,id2]
|
// storebound play products [--dry] [--only id1,id2]
|
||||||
// Per product: convertRegionPrices (USD base -> every region at local price points, plus regionsVersion), your
|
// Per product: convertRegionPrices (USD base -> every region at local price points, plus regionsVersion), your
|
||||||
// explicit overrides on top, PATCH ...?allowMissing=true (create or update), then activate the purchase option
|
// explicit overrides on top, PATCH ...?allowMissing=true (create or update), then activate the purchase option
|
||||||
// (new options start as DRAFT) with purchaseOptions:batchUpdateStates. Idempotent.
|
// (new options start as DRAFT) with purchaseOptions:batchUpdateStates. Idempotent.
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
// Upload an AAB (or reuse an uploaded versionCode) and put it on one or more tracks in one edit, with the "What's new"
|
// Upload an AAB (or reuse an uploaded versionCode) and put it on one or more tracks in one edit, with the "What's new"
|
||||||
// of every listing language as release notes.
|
// of every listing language as release notes.
|
||||||
// crt-ship play release app-release.aab [--internal completed] [--production draft] [--name "1.0.0 (3)"] [--dry]
|
// storebound play release app-release.aab [--internal completed] [--production draft] [--name "1.0.0 (3)"] [--dry]
|
||||||
// crt-ship play release --version-code 3 --production draft
|
// storebound play release --version-code 3 --production draft
|
||||||
// Tracks: internal, alpha (closed), beta (open), production; status completed | draft | inProgress | halted.
|
// Tracks: internal, alpha (closed), beta (open), production; status completed | draft | inProgress | halted.
|
||||||
// Without a track flag: internal, completed. A production release that is not a draft asks for confirmation.
|
// Without a track flag: internal, completed. A production release that is not a draft asks for confirmation.
|
||||||
// Draft app (never published): Play only accepts status "draft" on any track; the first production release is sent
|
// Draft app (never published): Play only accepts status "draft" on any track; the first production release is sent
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Read-only overview: tracks and releases, listing languages, one-time products and their purchase option states.
|
// Read-only overview: tracks and releases, listing languages, one-time products and their purchase option states.
|
||||||
// crt-ship play status [--json]
|
// storebound play status [--json]
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
import { need } from '../lib/ctx';
|
import { need } from '../lib/ctx';
|
||||||
import { playClient } from './client';
|
import { playClient } from './client';
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
// Playwright is not a dependency of crt-ship: it is resolved from the project (or the crt-ship folder), so a project
|
// Playwright is not a dependency of storebound: it is resolved from the project (or the storebound folder), so a project
|
||||||
// that never renders screenshots never downloads a browser. Launch order: Playwright's own Chromium, then an installed
|
// that never renders screenshots never downloads a browser. Launch order: Playwright's own Chromium, then an installed
|
||||||
// Google Chrome (channel "chrome"), so `bunx playwright install chromium` is optional when Chrome is there.
|
// Google Chrome (channel "chrome"), so `bunx playwright install chromium` is optional when Chrome is there.
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Raw frames from a running build of your game (headless Chromium, mobile viewport, touch, device scale).
|
// Raw frames from a running build of your game (headless Chromium, mobile viewport, touch, device scale).
|
||||||
// crt-ship shots capture [--lang en,tr] [--only hero,shop] [--device phone|tablet]
|
// storebound shots capture [--lang en,tr] [--only hero,shop] [--device phone|tablet]
|
||||||
// Each entry of shots.capture.shots: { path, waitFor?: JS expression that turns true, eval?: [JS], delayMs?, device? }.
|
// Each entry of shots.capture.shots: { path, waitFor?: JS expression that turns true, eval?: [JS], delayMs?, device? }.
|
||||||
// URL = baseUrl + path + (? or &) + query, with "{lang}" replaced. Frames go to <shots.frames>/<lang>/<device>/<name>.png.
|
// URL = baseUrl + path + (? or &) + query, with "{lang}" replaced. Frames go to <shots.frames>/<lang>/<device>/<name>.png.
|
||||||
// The frame is the screen BELOW the status bar (the template draws one), so the viewport is phone.w x phone.h.
|
// The frame is the screen BELOW the status bar (the template draws one), so the viewport is phone.w x phone.h.
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<link rel="stylesheet" href="/fonts/fonts.css">
|
<link rel="stylesheet" href="/fonts/fonts.css">
|
||||||
<!-- Play feature graphic, 1024 x 500: logo (or the app name) on the left, a tilted phone with one frame on the right.
|
<!-- Play feature graphic, 1024 x 500: logo (or the app name) on the left, a tilted phone with one frame on the right.
|
||||||
feature.html?lang=<id>. Rendered by `crt-ship shots render`. Keep text out of it: Play overlays its own UI. -->
|
feature.html?lang=<id>. Rendered by `storebound shots render`. Keep text out of it: Play overlays its own UI. -->
|
||||||
<style>
|
<style>
|
||||||
* { box-sizing: border-box; margin: 0; padding: 0; }
|
* { box-sizing: border-box; margin: 0; padding: 0; }
|
||||||
html, body { width: 1024px; height: 500px; overflow: hidden; background: #000; }
|
html, body { width: 1024px; height: 500px; overflow: hidden; background: #000; }
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
// Downloads the fonts the screenshot template needs, subset by Google Fonts (css2 `text=`) to exactly the characters
|
// Downloads the fonts the screenshot template needs, subset by Google Fonts (css2 `text=`) to exactly the characters
|
||||||
// your copy uses, so even CJK stays small: title + body family for Latin text, plus one Noto family per non-Latin
|
// your copy uses, so even CJK stays small: title + body family for Latin text, plus one Noto family per non-Latin
|
||||||
// script found in the copy (CJK, Arabic, Hebrew, Devanagari, Thai, Cyrillic / Greek).
|
// script found in the copy (CJK, Arabic, Hebrew, Devanagari, Thai, Cyrillic / Greek).
|
||||||
// crt-ship shots fonts (re-run after editing the copy)
|
// storebound shots fonts (re-run after editing the copy)
|
||||||
// Out: <project>/.crt-ship/fonts/*.woff2 + fonts.css. All of these fonts are SIL Open Font License 1.1.
|
// Out: <project>/.storebound/fonts/*.woff2 + fonts.css. All of these fonts are SIL Open Font License 1.1.
|
||||||
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
import type { Ctx } from '../lib/ctx';
|
import type { Ctx } from '../lib/ctx';
|
||||||
|
|
@ -28,7 +28,7 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const { config, root, resolve } = ctx.loaded;
|
const { config, root, resolve } = ctx.loaded;
|
||||||
const shots = need(config.shots, 'shots');
|
const shots = need(config.shots, 'shots');
|
||||||
const copy = JSON.parse(readFileSync(resolve(shots.copy), 'utf8')) as CopyFile;
|
const copy = JSON.parse(readFileSync(resolve(shots.copy), 'utf8')) as CopyFile;
|
||||||
const dir = join(root, '.crt-ship', 'fonts');
|
const dir = join(root, '.storebound', 'fonts');
|
||||||
mkdirSync(dir, { recursive: true });
|
mkdirSync(dir, { recursive: true });
|
||||||
const title = shots.fonts?.title ?? 'Lilita One', body = shots.fonts?.body ?? 'Montserrat';
|
const title = shots.fonts?.title ?? 'Lilita One', body = shots.fonts?.body ?? 'Montserrat';
|
||||||
|
|
||||||
|
|
@ -45,7 +45,7 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
for (const ch of config.app.name) latin.add(ch);
|
for (const ch of config.app.name) latin.add(ch);
|
||||||
const latinChars = [...latin].sort().join('');
|
const latinChars = [...latin].sort().join('');
|
||||||
|
|
||||||
let css = '/* Generated by crt-ship shots fonts (Google Fonts, SIL Open Font License 1.1), subset to the copy. */\n';
|
let css = '/* Generated by storebound shots fonts (Google Fonts, SIL Open Font License 1.1), subset to the copy. */\n';
|
||||||
const jobs: [string, string, string, boolean][] = [[title, 'title', latinChars, false], [body, 'body', latinChars, true],
|
const jobs: [string, string, string, boolean][] = [[title, 'title', latinChars, false], [body, 'body', latinChars, true],
|
||||||
...[...scripts.entries()].map(([slug, s]) => [s.family, slug, [...s.chars].sort().join(''), true] as [string, string, string, boolean])];
|
...[...scripts.entries()].map(([slug, s]) => [s.family, slug, [...s.chars].sort().join(''), true] as [string, string, string, boolean])];
|
||||||
for (const [family, slug, chars, variable] of jobs) {
|
for (const [family, slug, chars, variable] of jobs) {
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
// JPEG copies of the Play renders (play, tab7, tab10, feature): about 4x smaller, so `play images` uploads much faster.
|
// JPEG copies of the Play renders (play, tab7, tab10, feature): about 4x smaller, so `play images` uploads much faster.
|
||||||
// The App Store screenshots stay PNG.
|
// The App Store screenshots stay PNG.
|
||||||
// crt-ship shots jpeg [--q 92] [--lang en,tr]
|
// storebound shots jpeg [--q 92] [--lang en,tr]
|
||||||
import { existsSync, readdirSync } from 'node:fs';
|
import { existsSync, readdirSync } from 'node:fs';
|
||||||
import { join } from 'node:path';
|
import { join } from 'node:path';
|
||||||
import { spawnSync } from 'node:child_process';
|
import { spawnSync } from 'node:child_process';
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
// Store screenshots + Play feature graphic at exact pixel sizes, from raw game frames and per-language copy.
|
// Store screenshots + Play feature graphic at exact pixel sizes, from raw game frames and per-language copy.
|
||||||
// crt-ship shots render [--lang en,tr] [--size ios69,play,feature] [--scenes 1,3] [--no-sheet] [--port 8792]
|
// storebound shots render [--lang en,tr] [--size ios69,play,feature] [--scenes 1,3] [--no-sheet] [--port 8792]
|
||||||
// Out: <shots.out>/<lang>/<size>/NN.png (24-bit RGB: Play rejects alpha / palette PNGs), <lang>/feature/1024x500.png,
|
// Out: <shots.out>/<lang>/<size>/NN.png (24-bit RGB: Play rejects alpha / palette PNGs), <lang>/feature/1024x500.png,
|
||||||
// and <lang>/sheet.png (contact sheet of every size, for a quick review). Needs playwright + ffmpeg.
|
// and <lang>/sheet.png (contact sheet of every size, for a quick review). Needs playwright + ffmpeg.
|
||||||
import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
|
import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
|
||||||
|
|
@ -26,8 +26,8 @@ export async function run(ctx: Ctx): Promise<void> {
|
||||||
const problems = validateCopy(copy, shots, langs);
|
const problems = validateCopy(copy, shots, langs);
|
||||||
if (problems.length) throw new Error('shots copy:\n ' + problems.join('\n '));
|
if (problems.length) throw new Error('shots copy:\n ' + problems.join('\n '));
|
||||||
const framesDir = resolve(shots.frames), outDir = resolve(shots.out);
|
const framesDir = resolve(shots.frames), outDir = resolve(shots.out);
|
||||||
const fontsDir = join(root, '.crt-ship', 'fonts');
|
const fontsDir = join(root, '.storebound', 'fonts');
|
||||||
if (!existsSync(join(fontsDir, 'fonts.css'))) warn('shots', 'no .crt-ship/fonts/fonts.css: run `crt-ship shots fonts` first (falling back to system fonts)');
|
if (!existsSync(join(fontsDir, 'fonts.css'))) warn('shots', 'no .storebound/fonts/fonts.css: run `storebound shots fonts` first (falling back to system fonts)');
|
||||||
const phone = { ...DEFAULT_PHONE, ...shots.phone }, tablet = { ...DEFAULT_TABLET, ...shots.tablet };
|
const phone = { ...DEFAULT_PHONE, ...shots.phone }, tablet = { ...DEFAULT_TABLET, ...shots.tablet };
|
||||||
const rtl = new Map(config.languages.map(l => [l.id, !!l.rtl] as const));
|
const rtl = new Map(config.languages.map(l => [l.id, !!l.rtl] as const));
|
||||||
const fonts = { title: shots.fonts?.title ?? 'Lilita One', body: shots.fonts?.body ?? 'Montserrat' };
|
const fonts = { title: shots.fonts?.title ?? 'Lilita One', body: shots.fonts?.body ?? 'Montserrat' };
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
<meta charset="utf-8">
|
<meta charset="utf-8">
|
||||||
<link rel="stylesheet" href="/fonts/fonts.css">
|
<link rel="stylesheet" href="/fonts/fonts.css">
|
||||||
<!--
|
<!--
|
||||||
Store screenshot template (rendered by `crt-ship shots render`, served by its local server).
|
Store screenshot template (rendered by `storebound shots render`, served by its local server).
|
||||||
template.html?s=<scene id>&w=<px>&h=<px>&lang=<id>[&device=tablet]
|
template.html?s=<scene id>&w=<px>&h=<px>&lang=<id>[&device=tablet]
|
||||||
/job.json gives the scene (palette, frames, badge slots), the words for this language and the font families.
|
/job.json gives the scene (palette, frames, badge slots), the words for this language and the font families.
|
||||||
Layout: everything is in u = W / 100; the text block is measured first, then the phone fills the room below it.
|
Layout: everything is in u = W / 100; the text block is measured first, then the phone fills the room below it.
|
||||||
|
|
|
||||||
|
|
@ -1,13 +1,13 @@
|
||||||
{
|
{
|
||||||
"name": "crt-ship",
|
"name": "storebound",
|
||||||
"version": "0.1.0",
|
"version": "0.1.0",
|
||||||
"description": "My toolchain for shipping mobile games to Google Play and the App Store: a Bun CLI plus Claude Code skills.",
|
"description": "My toolchain for shipping mobile games to Google Play and the App Store: a Bun CLI plus Claude Code skills.",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"author": "CRTkafa",
|
"author": "CRTkafa",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"repository": { "type": "git", "url": "https://git.crt.fyi/CRT/crt-ship.git" },
|
"repository": { "type": "git", "url": "https://git.crt.fyi/CRT/storebound.git" },
|
||||||
"keywords": ["google-play", "app-store-connect", "mobile-games", "store-listing", "in-app-purchases", "screenshots", "claude-code-plugin"],
|
"keywords": ["google-play", "app-store-connect", "mobile-games", "store-listing", "in-app-purchases", "screenshots", "claude-code-plugin"],
|
||||||
"bin": { "crt-ship": "./cli/index.ts" },
|
"bin": { "storebound": "./cli/index.ts" },
|
||||||
"exports": { ".": "./cli/lib/config.ts" },
|
"exports": { ".": "./cli/lib/config.ts" },
|
||||||
"files": ["cli", "templates", "skills", "bin", ".claude-plugin", "README.md", "LICENSE", "CHANGELOG.md"],
|
"files": ["cli", "templates", "skills", "bin", ".claude-plugin", "README.md", "LICENSE", "CHANGELOG.md"],
|
||||||
"engines": { "bun": ">=1.1" },
|
"engines": { "bun": ">=1.1" },
|
||||||
|
|
|
||||||
|
|
@ -5,19 +5,19 @@ description: Generate every app icon a mobile game needs from one artwork - App
|
||||||
|
|
||||||
# App icons from one artwork
|
# App icons from one artwork
|
||||||
|
|
||||||
CLI: `crt-ship icons` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts icons`). Needs `ffmpeg` (`cwebp` optional).
|
CLI: `storebound icons` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts icons`). Needs `ffmpeg` (`cwebp` optional).
|
||||||
|
|
||||||
## Inputs (`icons` in crt-ship.config.ts)
|
## Inputs (`icons` in storebound.config.ts)
|
||||||
- `composite`: 1024 x 1024 opaque full icon (stores, iOS, web)
|
- `composite`: 1024 x 1024 opaque full icon (stores, iOS, web)
|
||||||
- `foreground`: 1024 RGBA, the subject on transparency (adaptive + maskable)
|
- `foreground`: 1024 RGBA, the subject on transparency (adaptive + maskable)
|
||||||
- `background`: 1024 opaque background layer
|
- `background`: 1024 opaque background layer
|
||||||
- outputs: `out` (store icons), `web`, `capacitorAssets` + `capacitorCommand`, `androidRes`
|
- outputs: `out` (store icons), `web`, `capacitorAssets` + `capacitorCommand`, `androidRes`
|
||||||
|
|
||||||
## Steps
|
## Steps
|
||||||
1. Put the three PNGs in the project, set the paths, `crt-ship check`.
|
1. Put the three PNGs in the project, set the paths, `storebound check`.
|
||||||
2. `crt-ship icons --dry` lists every file it will write; then `crt-ship icons`.
|
2. `storebound icons --dry` lists every file it will write; then `storebound icons`.
|
||||||
3. With Capacitor: set `capacitorAssets` (e.g. `assets`) and
|
3. With Capacitor: set `capacitorAssets` (e.g. `assets`) and
|
||||||
`capacitorCommand: 'bunx @capacitor/assets generate --assetPath assets'`; crt-ship writes the three sources, runs it,
|
`capacitorCommand: 'bunx @capacitor/assets generate --assetPath assets'`; storebound writes the three sources, runs it,
|
||||||
and then redraws the Android legacy icons (step order matters).
|
and then redraws the Android legacy icons (step order matters).
|
||||||
4. Verify: `sips -g hasAlpha store/icons/app-store-1024.png` says no; install on an Android device with a circle
|
4. Verify: `sips -g hasAlpha store/icons/app-store-1024.png` says no; install on an Android device with a circle
|
||||||
launcher mask and an old launcher (legacy icons); check the web favicon and the PWA maskable preview.
|
launcher mask and an old launcher (legacy icons); check the web favicon and the PWA maskable preview.
|
||||||
|
|
@ -26,9 +26,9 @@ CLI: `crt-ship icons` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts icons`). Needs
|
||||||
- **Adaptive foreground scale ~0.7**: the anydpi-v26 xml insets both layers 16.7 %, and launchers mask the visible
|
- **Adaptive foreground scale ~0.7**: the anydpi-v26 xml insets both layers 16.7 %, and launchers mask the visible
|
||||||
part (often a circle). At 0.7 the subject's corners sit just inside the circle. Tune with `adaptiveScale`.
|
part (often a circle). At 0.7 the subject's corners sit just inside the circle. Tune with `adaptiveScale`.
|
||||||
- **Legacy icons**: @capacitor/assets crops the full square artwork into `ic_launcher` / `ic_launcher_round`, cutting
|
- **Legacy icons**: @capacitor/assets crops the full square artwork into `ic_launcher` / `ic_launcher_round`, cutting
|
||||||
off anything near the corners. crt-ship redraws them from the adaptive composite with a circle and a 22 % rounded
|
off anything near the corners. storebound redraws them from the adaptive composite with a circle and a 22 % rounded
|
||||||
square mask (4x supersampled).
|
square mask (4x supersampled).
|
||||||
- **App Store 1024 must have no alpha channel** (upload or review fails); crt-ship writes rgb24.
|
- **App Store 1024 must have no alpha channel** (upload or review fails); storebound writes rgb24.
|
||||||
- Stores and launchers round the corners themselves: deliver full squares, never pre-rounded icons.
|
- Stores and launchers round the corners themselves: deliver full squares, never pre-rounded icons.
|
||||||
- Web icons as 256-colour PNGs (about a third of the size); maskable icon keeps the subject in the 80 % safe zone.
|
- Web icons as 256-colour PNGs (about a third of the size); maskable icon keeps the subject in the 80 % safe zone.
|
||||||
- Play listing icon is 512 x 512, separate from the launcher icons in the AAB.
|
- Play listing icon is 512 x 512, separate from the launcher icons in the AAB.
|
||||||
|
|
|
||||||
|
|
@ -5,21 +5,21 @@ description: Step-by-step first (and later) App Store release of a mobile game -
|
||||||
|
|
||||||
# App Store: first release
|
# App Store: first release
|
||||||
|
|
||||||
The CLI is `crt-ship` (on PATH while this plugin is enabled; otherwise `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
The CLI is `storebound` (on PATH while this plugin is enabled; otherwise `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
||||||
Config: `crt-ship.config.ts`; credentials: `ASC_KEY_ID`, `ASC_ISSUER_ID`, `ASC_P8` (env or
|
Config: `storebound.config.ts`; credentials: `ASC_KEY_ID`, `ASC_ISSUER_ID`, `ASC_P8` (env or
|
||||||
`.crt-ship/credentials.json`, gitignored). All commands are idempotent and have `--dry`. Run `crt-ship check` first.
|
`.storebound/credentials.json`, gitignored). All commands are idempotent and have `--dry`. Run `storebound check` first.
|
||||||
|
|
||||||
**Ask the owner before submitting for review, releasing, or canceling a submission.** The final "Submit for Review"
|
**Ask the owner before submitting for review, releasing, or canceling a submission.** The final "Submit for Review"
|
||||||
of a first version is the owner's click.
|
of a first version is the owner's click.
|
||||||
|
|
||||||
## Steps (API = crt-ship, UI = App Store Connect / Xcode by hand)
|
## Steps (API = storebound, UI = App Store Connect / Xcode by hand)
|
||||||
|
|
||||||
1. **UI · API key.** App Store Connect > Users and Access > Integrations > App Store Connect API > Team Keys > +
|
1. **UI · API key.** App Store Connect > Users and Access > Integrations > App Store Connect API > Team Keys > +
|
||||||
(Admin or App Manager). Download `AuthKey_<KEYID>.p8` once, keep it in `~/.appstoreconnect/private_keys/`, note the
|
(Admin or App Manager). Download `AuthKey_<KEYID>.p8` once, keep it in `~/.appstoreconnect/private_keys/`, note the
|
||||||
Key ID and Issuer ID. The same key signs builds (`-allowProvisioningUpdates`).
|
Key ID and Issuer ID. The same key signs builds (`-allowProvisioningUpdates`).
|
||||||
2. **API · Bundle id.** `crt-ship apple bundle` registers it (Certificates, Identifiers & Profiles).
|
2. **API · Bundle id.** `storebound apple bundle` registers it (Certificates, Identifiers & Profiles).
|
||||||
3. **UI · App record.** Apps > + > New App: iOS, name, primary language, the bundle id, SKU. **No API for this.**
|
3. **UI · App record.** Apps > + > New App: iOS, name, primary language, the bundle id, SKU. **No API for this.**
|
||||||
Then `crt-ship apple status` finds it (put the Apple ID in `apple.appId` to skip the lookup).
|
Then `storebound apple status` finds it (put the Apple ID in `apple.appId` to skip the lookup).
|
||||||
4. **Local · Info.plist.** `ITSAppUsesNonExemptEncryption = NO` (HTTPS only) so builds skip export compliance;
|
4. **Local · Info.plist.** `ITSAppUsesNonExemptEncryption = NO` (HTTPS only) so builds skip export compliance;
|
||||||
`NSUserTrackingUsageDescription` if ads use the IDFA; privacy policy reachable inside the app (guideline 5.1.1).
|
`NSUserTrackingUsageDescription` if ads use the IDFA; privacy policy reachable inside the app (guideline 5.1.1).
|
||||||
5. **Local · Build + upload** (Mac, no Xcode account login needed, the API key does signing):
|
5. **Local · Build + upload** (Mac, no Xcode account login needed, the API key does signing):
|
||||||
|
|
@ -31,22 +31,22 @@ of a first version is the owner's click.
|
||||||
```
|
```
|
||||||
ExportOptions.plist: `method` app-store-connect, `destination` upload, `teamID` <your team>, `signingStyle`
|
ExportOptions.plist: `method` app-store-connect, `destination` upload, `teamID` <your team>, `signingStyle`
|
||||||
automatic. `MARKETING_VERSION` / `CURRENT_PROJECT_VERSION` overrides beat the project values; the build number must
|
automatic. `MARKETING_VERSION` / `CURRENT_PROJECT_VERSION` overrides beat the project values; the build number must
|
||||||
grow per version. Processing takes 5-30 min (`crt-ship apple status` shows VALID).
|
grow per version. Processing takes 5-30 min (`storebound apple status` shows VALID).
|
||||||
6. **UI · TestFlight.** Create an internal group with "access to all builds" (hasAccessToAllBuilds) once: every new
|
6. **UI · TestFlight.** Create an internal group with "access to all builds" (hasAccessToAllBuilds) once: every new
|
||||||
build reaches the testers automatically. Sandbox testers: Users and Access > Sandbox.
|
build reaches the testers automatically. Sandbox testers: Users and Access > Sandbox.
|
||||||
7. **API · Version + text.** Fill `store/appstore.md`, then `crt-ship apple listing --version 1.0.0 --build 3`
|
7. **API · Version + text.** Fill `store/appstore.md`, then `storebound apple listing --version 1.0.0 --build 3`
|
||||||
(version, copyright, MANUAL release, build, name / subtitle / privacy URL, description / keywords / promo / URLs).
|
(version, copyright, MANUAL release, build, name / subtitle / privacy URL, description / keywords / promo / URLs).
|
||||||
8. **API · Screenshots.** `store-screenshots` skill, then
|
8. **API · Screenshots.** `store-screenshots` skill, then
|
||||||
`crt-ship apple screenshots > .crt-ship/asc-shots.log 2>&1 &` (6.9" + 6.5" per locale, MD5-idempotent).
|
`storebound apple screenshots > .storebound/asc-shots.log 2>&1 &` (6.9" + 6.5" per locale, MD5-idempotent).
|
||||||
9. **API · App info.** `crt-ship apple appinfo`: categories, age rating declaration, content rights, Free price,
|
9. **API · App info.** `storebound apple appinfo`: categories, age rating declaration, content rights, Free price,
|
||||||
all territories.
|
all territories.
|
||||||
10. **API · Review details.** `crt-ship apple review-details` (contact from `.crt-ship/credentials.json`
|
10. **API · Review details.** `storebound apple review-details` (contact from `.storebound/credentials.json`
|
||||||
`reviewContact`, or `--contact-from <Apple ID of another app of the team>`; notes from the config).
|
`reviewContact`, or `--contact-from <Apple ID of another app of the team>`; notes from the config).
|
||||||
11. **API + UI · In-app purchases.** `store-iap-setup` skill. First IAPs go to review **with** this version.
|
11. **API + UI · In-app purchases.** `store-iap-setup` skill. First IAPs go to review **with** this version.
|
||||||
12. **UI · App Privacy.** `store-declarations` skill (nutrition labels), then **Publish**.
|
12. **UI · App Privacy.** `store-declarations` skill (nutrition labels), then **Publish**.
|
||||||
13. **UI · Submit.** Version page > Add for Review (with the IAPs in the same draft submission) > Submit for Review
|
13. **UI · Submit.** Version page > Add for Review (with the IAPs in the same draft submission) > Submit for Review
|
||||||
(owner). Release type MANUAL means the owner presses "Release" after approval.
|
(owner). Release type MANUAL means the owner presses "Release" after approval.
|
||||||
14. **Verify.** `crt-ship apple status`: version WAITING_FOR_REVIEW, IAPs WAITING_FOR_REVIEW, one review submission.
|
14. **Verify.** `storebound apple status`: version WAITING_FOR_REVIEW, IAPs WAITING_FOR_REVIEW, one review submission.
|
||||||
|
|
||||||
## Gotchas
|
## Gotchas
|
||||||
|
|
||||||
|
|
@ -54,14 +54,14 @@ of a first version is the owner's click.
|
||||||
- First consumable / non-consumable IAPs must be submitted together with an app version, only from the IAP page
|
- First consumable / non-consumable IAPs must be submitted together with an app version, only from the IAP page
|
||||||
("Add for Review" puts them into the draft submission). The API (`inAppPurchaseSubmissions`) answers
|
("Add for Review" puts them into the draft submission). The API (`inAppPurchaseSubmissions`) answers
|
||||||
`FIRST_*_MUST_BE_SUBMITTED_ON_VERSION`. If the version was already submitted without them: cancel the review
|
`FIRST_*_MUST_BE_SUBMITTED_ON_VERSION`. If the version was already submitted without them: cancel the review
|
||||||
submission (`crt-ship apple status --cancel-submission <id>`, PATCH canceled: true), wait a minute, add the IAPs
|
submission (`storebound apple status --cancel-submission <id>`, PATCH canceled: true), wait a minute, add the IAPs
|
||||||
from their page, then resubmit.
|
from their page, then resubmit.
|
||||||
- App Privacy (data types, purposes, linked, tracking) is UI-only and must be **published**, not just saved.
|
- App Privacy (data types, purposes, linked, tracking) is UI-only and must be **published**, not just saved.
|
||||||
- Screenshot sizes: 6.9" 1320 x 2868 (`APP_IPHONE_67`) is required; 6.5" 1284 x 2778 (`APP_IPHONE_65`) recommended.
|
- Screenshot sizes: 6.9" 1320 x 2868 (`APP_IPHONE_67`) is required; 6.5" 1284 x 2778 (`APP_IPHONE_65`) recommended.
|
||||||
PNG without alpha. Up to 10 per set. Apple processes uploads async; failures show as FAILED later.
|
PNG without alpha. Up to 10 per set. Apple processes uploads async; failures show as FAILED later.
|
||||||
- App Store icon (1024) must have **no alpha channel** (`crt-ship icons` writes rgb24).
|
- App Store icon (1024) must have **no alpha channel** (`storebound icons` writes rgb24).
|
||||||
- Limits: name 30, subtitle 30, promotional text 170, keywords 100 bytes (UTF-8, no spaces after commas),
|
- Limits: name 30, subtitle 30, promotional text 170, keywords 100 bytes (UTF-8, no spaces after commas),
|
||||||
description 4000. No "What's New" on a first version.
|
description 4000. No "What's New" on a first version.
|
||||||
- Guideline 5.1.1: the privacy policy link must be inside the app too (Settings > Privacy), not only in the listing.
|
- Guideline 5.1.1: the privacy policy link must be inside the app too (Settings > Privacy), not only in the listing.
|
||||||
- `xcodebuild` with Capacitor needs a UTF-8 locale (`export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8`).
|
- `xcodebuild` with Capacitor needs a UTF-8 locale (`export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8`).
|
||||||
- 500 / 503 from the API happen; crt-ship retries with backoff.
|
- 500 / 503 from the API happen; storebound retries with backoff.
|
||||||
|
|
|
||||||
|
|
@ -5,14 +5,14 @@ description: Step-by-step first (and later) Google Play release of a mobile game
|
||||||
|
|
||||||
# Google Play: first release
|
# Google Play: first release
|
||||||
|
|
||||||
The CLI is `crt-ship` (on PATH while this plugin is enabled; otherwise `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
The CLI is `storebound` (on PATH while this plugin is enabled; otherwise `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
||||||
It reads `crt-ship.config.ts` in the project (create with `crt-ship init`) and credentials from env or
|
It reads `storebound.config.ts` in the project (create with `storebound init`) and credentials from env or
|
||||||
`.crt-ship/credentials.json` (gitignored). Every write command has `--dry`. Run `crt-ship check` first.
|
`.storebound/credentials.json` (gitignored). Every write command has `--dry`. Run `storebound check` first.
|
||||||
|
|
||||||
**Ask the owner before anything public or irreversible**: production releases, "Send for review", publishing,
|
**Ask the owner before anything public or irreversible**: production releases, "Send for review", publishing,
|
||||||
deleting products. Sending a first release for review is the owner's action in the Console, not yours.
|
deleting products. Sending a first release for review is the owner's action in the Console, not yours.
|
||||||
|
|
||||||
## Steps (API = crt-ship does it, UI = Play Console by hand)
|
## Steps (API = storebound does it, UI = Play Console by hand)
|
||||||
|
|
||||||
1. **UI · Create the app.** Play Console > Home > Create app: name, default language, Game, Free, declarations.
|
1. **UI · Create the app.** Play Console > Home > Create app: name, default language, Game, Free, declarations.
|
||||||
The package name is fixed by the first uploaded AAB.
|
The package name is fixed by the first uploaded AAB.
|
||||||
|
|
@ -28,23 +28,23 @@ deleting products. Sending a first release for review is the owner's action in t
|
||||||
4. **Local · Version.** versionName (e.g. 1.0.0) and a versionCode that always increases. Capacitor: set them in
|
4. **Local · Version.** versionName (e.g. 1.0.0) and a versionCode that always increases. Capacitor: set them in
|
||||||
`android/app/build.gradle` (or env-driven) before `./gradlew bundleRelease`.
|
`android/app/build.gradle` (or env-driven) before `./gradlew bundleRelease`.
|
||||||
5. **UI or API · First upload.** The very first AAB may need the Console (Testing > Internal testing > Create new
|
5. **UI or API · First upload.** The very first AAB may need the Console (Testing > Internal testing > Create new
|
||||||
release) so Play links the package name; after that: `crt-ship play release app-release.aab` (internal, completed).
|
release) so Play links the package name; after that: `storebound play release app-release.aab` (internal, completed).
|
||||||
Add testers (internal testing list) and **license testers** (Settings > License testing) so test purchases are free.
|
Add testers (internal testing list) and **license testers** (Settings > License testing) so test purchases are free.
|
||||||
6. **API · Listing text.** Fill `store/listing.md` (one section per language), then `crt-ship play listing`.
|
6. **API · Listing text.** Fill `store/listing.md` (one section per language), then `storebound play listing`.
|
||||||
It also sets contact email + website (website = the domain serving app-ads.txt).
|
It also sets contact email + website (website = the domain serving app-ads.txt).
|
||||||
7. **API · Graphics.** Render (`store-screenshots` skill), `crt-ship shots jpeg`, then
|
7. **API · Graphics.** Render (`store-screenshots` skill), `storebound shots jpeg`, then
|
||||||
`crt-ship play images > .crt-ship/play-images.log 2>&1 &` and follow the log (it is slow: one edit per language).
|
`storebound play images > .storebound/play-images.log 2>&1 &` and follow the log (it is slow: one edit per language).
|
||||||
8. **API · In-app products.** `store-iap-setup` skill (`crt-ship play products`). Needs a build with the BILLING
|
8. **API · In-app products.** `store-iap-setup` skill (`storebound play products`). Needs a build with the BILLING
|
||||||
permission on any track first.
|
permission on any track first.
|
||||||
9. **API · Data safety.** Answers in `dataSafety` of the config, `crt-ship play data-safety`, then check the summary
|
9. **API · Data safety.** Answers in `dataSafety` of the config, `storebound play data-safety`, then check the summary
|
||||||
in Policy and programs > App content > Data safety.
|
in Policy and programs > App content > Data safety.
|
||||||
10. **UI · App content.** `store-declarations` skill: privacy policy, ads, app access, content rating (IARC), target
|
10. **UI · App content.** `store-declarations` skill: privacy policy, ads, app access, content rating (IARC), target
|
||||||
audience, advertising ID, government / financial / health / news, data safety review.
|
audience, advertising ID, government / financial / health / news, data safety review.
|
||||||
11. **UI · Store settings.** Category + tags, contact details.
|
11. **UI · Store settings.** Category + tags, contact details.
|
||||||
12. **API + UI · Production.** `crt-ship play release --version-code N --production draft`, then in the Console:
|
12. **API + UI · Production.** `storebound play release --version-code N --production draft`, then in the Console:
|
||||||
Production > Countries/regions > Add countries > select all > Save; Production > the draft release > Edit >
|
Production > Countries/regions > Add countries > select all > Save; Production > the draft release > Edit >
|
||||||
Next > Save; Publishing overview > **Send changes for review** (owner).
|
Next > Save; Publishing overview > **Send changes for review** (owner).
|
||||||
13. **Verify.** `crt-ship play status` (tracks, listings, products), Console dashboard has no open tasks,
|
13. **Verify.** `storebound play status` (tracks, listings, products), Console dashboard has no open tasks,
|
||||||
Publishing overview shows "In review".
|
Publishing overview shows "In review".
|
||||||
|
|
||||||
## Gotchas
|
## Gotchas
|
||||||
|
|
@ -52,7 +52,7 @@ deleting products. Sending a first release for review is the owner's action in t
|
||||||
- **Draft app**: until the first release is reviewed, the API only accepts `status: draft` ("Only releases with
|
- **Draft app**: until the first release is reviewed, the API only accepts `status: draft` ("Only releases with
|
||||||
status draft may be created on draft app"). Create the production draft via API, finish in the Console (step 12).
|
status draft may be created on draft app"). Create the production draft via API, finish in the Console (step 12).
|
||||||
- **"A change was made to the application outside of this Edit"**: any Console save or other edit commit invalidates
|
- **"A change was made to the application outside of this Edit"**: any Console save or other edit commit invalidates
|
||||||
an open API edit. `crt-ship` redoes the edit automatically (3 retries) and uses one edit per language for images, but
|
an open API edit. `storebound` redoes the edit automatically (3 retries) and uses one edit per language for images, but
|
||||||
do not save things in the Console while uploads run.
|
do not save things in the Console while uploads run.
|
||||||
- Uploads (AAB, 100+ images) take minutes: run them in the background with a log file and watch progress lines.
|
- Uploads (AAB, 100+ images) take minutes: run them in the background with a log file and watch progress lines.
|
||||||
- **Personal developer accounts** created after Nov 2023 need a closed test with 12+ testers for 14 days before
|
- **Personal developer accounts** created after Nov 2023 need a closed test with 12+ testers for 14 days before
|
||||||
|
|
@ -61,7 +61,7 @@ deleting products. Sending a first release for review is the owner's action in t
|
||||||
Feature graphic 1024 x 500 required. PNG without alpha, or JPEG (q92 is 4x smaller and uploads faster).
|
Feature graphic 1024 x 500 required. PNG without alpha, or JPEG (q92 is 4x smaller and uploads faster).
|
||||||
- Play listing limits: title 30, short 80, full 4000, release notes 500 (checked locally before upload).
|
- Play listing limits: title 30, short 80, full 4000, release notes 500 (checked locally before upload).
|
||||||
- The legacy `inappproducts` API returns 403 "Please migrate to the new publishing API": use
|
- The legacy `inappproducts` API returns 403 "Please migrate to the new publishing API": use
|
||||||
`monetization.onetimeproducts` (what `crt-ship play products` does).
|
`monetization.onetimeproducts` (what `storebound play products` does).
|
||||||
- Wrong path casing on the new product endpoints returns an HTML 404, not JSON (`oneTimeProducts` camelCase for list
|
- Wrong path casing on the new product endpoints returns an HTML 404, not JSON (`oneTimeProducts` camelCase for list
|
||||||
and batchUpdateStates).
|
and batchUpdateStates).
|
||||||
- Website in the listing must be the exact domain whose `/app-ads.txt` lists your ad networks.
|
- Website in the listing must be the exact domain whose `/app-ads.txt` lists your ad networks.
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@ description: Write and host one studio-wide privacy policy page for all of a dev
|
||||||
|
|
||||||
# Studio-wide privacy policy
|
# Studio-wide privacy policy
|
||||||
|
|
||||||
Template: `store/privacy-policy.html` (from `crt-ship init`, or `${CLAUDE_PLUGIN_ROOT}/templates/privacy-policy.html`).
|
Template: `store/privacy-policy.html` (from `storebound init`, or `${CLAUDE_PLUGIN_ROOT}/templates/privacy-policy.html`).
|
||||||
A single static page, light/dark, mobile friendly, English + a second language section.
|
A single static page, light/dark, mobile friendly, English + a second language section.
|
||||||
|
|
||||||
## Steps
|
## Steps
|
||||||
|
|
@ -17,7 +17,7 @@ A single static page, light/dark, mobile friendly, English + a second language s
|
||||||
(date at the top), contact email.
|
(date at the top), contact email.
|
||||||
3. **Host** it at a stable URL on your developer website, the same domain that serves `app-ads.txt` and is named as
|
3. **Host** it at a stable URL on your developer website, the same domain that serves `app-ads.txt` and is named as
|
||||||
website in both listings (e.g. `https://example.com/privacy`). Any static host works.
|
website in both listings (e.g. `https://example.com/privacy`). Any static host works.
|
||||||
4. **Link it everywhere**: `app.privacyPolicyUrl` in `crt-ship.config.ts` (pushed by `crt-ship apple listing`), Play
|
4. **Link it everywhere**: `app.privacyPolicyUrl` in `storebound.config.ts` (pushed by `storebound apple listing`), Play
|
||||||
Console > App content > Privacy policy, and **inside the game** (Settings > Privacy opens the URL): App Store
|
Console > App content > Privacy policy, and **inside the game** (Settings > Privacy opens the URL): App Store
|
||||||
guideline 5.1.1 requires the in-app link.
|
guideline 5.1.1 requires the in-app link.
|
||||||
5. **Verify**: the URL answers 200 over HTTPS without login or cookie wall, the table matches the Data safety /
|
5. **Verify**: the URL answers 200 over HTTPS without login or cookie wall, the table matches the Data safety /
|
||||||
|
|
|
||||||
|
|
@ -6,20 +6,20 @@ description: Answer the store compliance forms for a mobile game - Google Play D
|
||||||
# Store declarations
|
# Store declarations
|
||||||
|
|
||||||
Templates: `store/declarations.md` (Play App content + IARC answers), `store/app-privacy.md` (Apple labels), both
|
Templates: `store/declarations.md` (Play App content + IARC answers), `store/app-privacy.md` (Apple labels), both
|
||||||
from `crt-ship init`. Data safety answers live in `dataSafety` of `crt-ship.config.ts`.
|
from `storebound init`. Data safety answers live in `dataSafety` of `storebound.config.ts`.
|
||||||
CLI: `crt-ship` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
CLI: `storebound` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`).
|
||||||
|
|
||||||
## Order
|
## Order
|
||||||
1. **Inventory first.** List every SDK and server call: what leaves the device, who receives it, can the player turn
|
1. **Inventory first.** List every SDK and server call: what leaves the device, who receives it, can the player turn
|
||||||
it off. The privacy policy (`privacy-policy` skill) must say the same; update it before the forms.
|
it off. The privacy policy (`privacy-policy` skill) must say the same; update it before the forms.
|
||||||
2. **Play Data safety (API).** Fill `dataSafety` (types not listed = not collected; `shared` = third party that is not
|
2. **Play Data safety (API).** Fill `dataSafety` (types not listed = not collected; `shared` = third party that is not
|
||||||
your service provider, e.g. ad networks; analytics vendors acting as processors are "collected" only).
|
your service provider, e.g. ad networks; analytics vendors acting as processors are "collected" only).
|
||||||
`crt-ship play data-safety --dry --csv store/data-safety.csv` to review, then `crt-ship play data-safety`.
|
`storebound play data-safety --dry --csv store/data-safety.csv` to review, then `storebound play data-safety`.
|
||||||
Then check the summary in Play Console > Policy and programs > App content > Data safety.
|
Then check the summary in Play Console > Policy and programs > App content > Data safety.
|
||||||
3. **Play App content (UI).** Policy and programs > App content, each card with `store/declarations.md`:
|
3. **Play App content (UI).** Policy and programs > App content, each card with `store/declarations.md`:
|
||||||
privacy policy, app access, ads, content rating (IARC questionnaire), target audience and content, news, COVID-19,
|
privacy policy, app access, ads, content rating (IARC questionnaire), target audience and content, news, COVID-19,
|
||||||
data safety, government apps, financial features, health, advertising ID.
|
data safety, government apps, financial features, health, advertising ID.
|
||||||
4. **Apple age rating (API).** `crt-ship apple appinfo` (all NONE except your overrides, e.g. `advertising: true`).
|
4. **Apple age rating (API).** `storebound apple appinfo` (all NONE except your overrides, e.g. `advertising: true`).
|
||||||
5. **Apple App Privacy (UI only).** App Store Connect > the app > App Privacy > Get Started / Edit, from
|
5. **Apple App Privacy (UI only).** App Store Connect > the app > App Privacy > Get Started / Edit, from
|
||||||
`store/app-privacy.md`; per data type: purposes > linked to identity > used for tracking. Then **Publish**.
|
`store/app-privacy.md`; per data type: purposes > linked to identity > used for tracking. Then **Publish**.
|
||||||
6. **Export compliance.** `ITSAppUsesNonExemptEncryption = NO` in Info.plist (standard HTTPS only).
|
6. **Export compliance.** `ITSAppUsesNonExemptEncryption = NO` in Info.plist (standard HTTPS only).
|
||||||
|
|
@ -34,7 +34,7 @@ creation: none. IARC: everything No except digital purchases Yes; target audienc
|
||||||
## Gotchas
|
## Gotchas
|
||||||
- The Data safety CSV import **replaces** the whole form.
|
- The Data safety CSV import **replaces** the whole form.
|
||||||
- `PSL_SUPPORTED_ACCOUNT_CREATION_METHODS` (e.g. `PSL_ACM_NONE`) is required even though Google's older sample CSV
|
- `PSL_SUPPORTED_ACCOUNT_CREATION_METHODS` (e.g. `PSL_ACM_NONE`) is required even though Google's older sample CSV
|
||||||
omits it: without it the import fails with "Response missing". crt-ship always writes it.
|
omits it: without it the import fails with "Response missing". storebound always writes it.
|
||||||
- "Optional" data is only allowed when the user can really choose for that data; otherwise required.
|
- "Optional" data is only allowed when the user can really choose for that data; otherwise required.
|
||||||
- Ads SDKs: read each network's own Play data safety guidance; adding a network can add data types.
|
- Ads SDKs: read each network's own Play data safety guidance; adding a network can add data types.
|
||||||
- Target audience under 13 pulls the app into the Families policy (certified ad networks, no ad id): only if true.
|
- Target audience under 13 pulls the app into the Families policy (certified ad networks, no ad id): only if true.
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@ description: Create and price in-app purchases (consumables, non-consumables lik
|
||||||
|
|
||||||
# In-app purchases on both stores
|
# In-app purchases on both stores
|
||||||
|
|
||||||
CLI: `crt-ship` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`). One list in `crt-ship.config.ts` `products[]` drives
|
CLI: `storebound` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`). One list in `storebound.config.ts` `products[]` drives
|
||||||
both stores: `id` (same on both), `type` (consumable | non_consumable), `usd` base price, optional `overrides`
|
both stores: `id` (same on both), `type` (consumable | non_consumable), `usd` base price, optional `overrides`
|
||||||
(`{ region: 'TR', currency: 'TRY', price: 99.99 }`), `listings` per language (title <= 30, description <= 55 for
|
(`{ region: 'TR', currency: 'TRY', price: 99.99 }`), `listings` per language (title <= 30, description <= 55 for
|
||||||
Apple), `reviewScreenshot`.
|
Apple), `reviewScreenshot`.
|
||||||
|
|
@ -15,20 +15,20 @@ Apple), `reviewScreenshot`.
|
||||||
- Apple: Paid Applications agreement + banking + tax active (Business > Agreements), the app record exists.
|
- Apple: Paid Applications agreement + banking + tax active (Business > Agreements), the app record exists.
|
||||||
|
|
||||||
## Google Play (API)
|
## Google Play (API)
|
||||||
1. `crt-ship check`, then `crt-ship play products --dry` (shows create/update and region count per product).
|
1. `storebound check`, then `storebound play products --dry` (shows create/update and region count per product).
|
||||||
2. `crt-ship play products`. Per product: `pricing:convertRegionPrices` (USD -> every region at local price points,
|
2. `storebound play products`. Per product: `pricing:convertRegionPrices` (USD -> every region at local price points,
|
||||||
and the `regionsVersion`), your overrides on top, `PATCH .../onetimeproducts/{id}?allowMissing=true®ionsVersion.version=...`
|
and the `regionsVersion`), your overrides on top, `PATCH .../onetimeproducts/{id}?allowMissing=true®ionsVersion.version=...`
|
||||||
(create or update), then `oneTimeProducts/{id}/purchaseOptions:batchUpdateStates` to activate (new options are DRAFT).
|
(create or update), then `oneTimeProducts/{id}/purchaseOptions:batchUpdateStates` to activate (new options are DRAFT).
|
||||||
3. Verify: `crt-ship play status` lists every product with `buy:ACTIVE`.
|
3. Verify: `storebound play status` lists every product with `buy:ACTIVE`.
|
||||||
4. Test: Play Console > Settings > License testing: add tester Gmail accounts; install from the internal testing
|
4. Test: Play Console > Settings > License testing: add tester Gmail accounts; install from the internal testing
|
||||||
link; purchases are free test orders.
|
link; purchases are free test orders.
|
||||||
|
|
||||||
## App Store (API + UI)
|
## App Store (API + UI)
|
||||||
1. `crt-ship apple iap --dry`, then `crt-ship apple iap`: creates missing products, localizations, a price schedule
|
1. `storebound apple iap --dry`, then `storebound apple iap`: creates missing products, localizations, a price schedule
|
||||||
(USA base + overrides; Apple equalizes the rest) and availability. Existing schedules are not changed (change prices
|
(USA base + overrides; Apple equalizes the rest) and availability. Existing schedules are not changed (change prices
|
||||||
in the UI if needed).
|
in the UI if needed).
|
||||||
2. Review screenshot per product (a real device size, e.g. 1290 x 2796, showing the item in the shop):
|
2. Review screenshot per product (a real device size, e.g. 1290 x 2796, showing the item in the shop):
|
||||||
`crt-ship apple iap-review`. States move to READY_TO_SUBMIT when complete.
|
`storebound apple iap-review`. States move to READY_TO_SUBMIT when complete.
|
||||||
3. **UI**: each IAP page > "Add for Review"; this puts them into the version's draft submission. Then submit the
|
3. **UI**: each IAP page > "Add for Review"; this puts them into the version's draft submission. Then submit the
|
||||||
version (owner, see appstore-first-release).
|
version (owner, see appstore-first-release).
|
||||||
4. Test: Sandbox testers (Users and Access > Sandbox) on device; or a StoreKit configuration file in Xcode for local
|
4. Test: Sandbox testers (Users and Access > Sandbox) on device; or a StoreKit configuration file in Xcode for local
|
||||||
|
|
@ -43,7 +43,7 @@ Apple), `reviewScreenshot`.
|
||||||
billing libraries see the product by id.
|
billing libraries see the product by id.
|
||||||
- Apple: first IAPs must ship with an app version ("FIRST_*_MUST_BE_SUBMITTED_ON_VERSION" from
|
- Apple: first IAPs must ship with an app version ("FIRST_*_MUST_BE_SUBMITTED_ON_VERSION" from
|
||||||
inAppPurchaseSubmissions). If the version is already in review without them: cancel the review submission
|
inAppPurchaseSubmissions). If the version is already in review without them: cancel the review submission
|
||||||
(`crt-ship apple status --cancel-submission <id>`, ask the owner), re-add via "Add for Review", resubmit.
|
(`storebound apple status --cancel-submission <id>`, ask the owner), re-add via "Add for Review", resubmit.
|
||||||
- Apple needs an exact existing price point for each manual price; the error lists the nearest ones.
|
- Apple needs an exact existing price point for each manual price; the error lists the nearest ones.
|
||||||
- Apple IAP description max 55 characters, display name max 30.
|
- Apple IAP description max 55 characters, display name max 30.
|
||||||
- Product ids can never be reused after deletion on either store. Never delete without the owner.
|
- Product ids can never be reused after deletion on either store. Never delete without the owner.
|
||||||
|
|
|
||||||
|
|
@ -5,7 +5,7 @@ description: Produce store screenshots and the Play feature graphic for a mobile
|
||||||
|
|
||||||
# Store screenshots
|
# Store screenshots
|
||||||
|
|
||||||
CLI: `crt-ship` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`). Needs `ffmpeg`, and `playwright` in the project
|
CLI: `storebound` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`). Needs `ffmpeg`, and `playwright` in the project
|
||||||
(`bun add -d playwright`; it uses Playwright's Chromium or an installed Google Chrome).
|
(`bun add -d playwright`; it uses Playwright's Chromium or an installed Google Chrome).
|
||||||
|
|
||||||
## Sizes (what each store wants)
|
## Sizes (what each store wants)
|
||||||
|
|
@ -22,19 +22,19 @@ CLI: `crt-ship` (or `bun ${CLAUDE_PLUGIN_ROOT}/cli/index.ts`). Needs `ffmpeg`, a
|
||||||
1. **Game switches.** Give the game URL params for screenshots: language, fixed seed, no ads / analytics / purchase
|
1. **Game switches.** Give the game URL params for screenshots: language, fixed seed, no ads / analytics / purchase
|
||||||
UI, skip tutorial, jump to a level, freeze at a moment. Frames must show real gameplay (store rule).
|
UI, skip tutorial, jump to a level, freeze at a moment. Frames must show real gameplay (store rule).
|
||||||
2. **Capture.** Configure `shots.capture` (baseUrl, query with `{lang}`, shots: path / waitFor / eval / delayMs /
|
2. **Capture.** Configure `shots.capture` (baseUrl, query with `{lang}`, shots: path / waitFor / eval / delayMs /
|
||||||
device). Start the game (production build preview), then `crt-ship shots capture --lang en` (phone 440 x 902 @3x
|
device). Start the game (production build preview), then `storebound shots capture --lang en` (phone 440 x 902 @3x
|
||||||
and tablet 800 x 1240 @2x by default; the template draws the status bar above). Frames are local, not committed.
|
and tablet 800 x 1240 @2x by default; the template draws the status bar above). Frames are local, not committed.
|
||||||
3. **Copy.** `store/shots/copy.json`: per language, per scene: `eyebrow`, `title` [white line, gold line], `sub`,
|
3. **Copy.** `store/shots/copy.json`: per language, per scene: `eyebrow`, `title` [white line, gold line], `sub`,
|
||||||
`badges` [[big, small]]. Short and true (only claim what is in the game); about 15 Latin characters per title line.
|
`badges` [[big, small]]. Short and true (only claim what is in the game); about 15 Latin characters per title line.
|
||||||
Natural marketing tone per language, not literal translation; use the game's own terms.
|
Natural marketing tone per language, not literal translation; use the game's own terms.
|
||||||
4. **Fonts.** `crt-ship shots fonts` downloads title/body fonts and a Noto subset for every non-Latin script found in
|
4. **Fonts.** `storebound shots fonts` downloads title/body fonts and a Noto subset for every non-Latin script found in
|
||||||
the copy (CJK, Arabic, Hebrew, Devanagari, Thai, Cyrillic/Greek). Re-run after copy edits.
|
the copy (CJK, Arabic, Hebrew, Devanagari, Thai, Cyrillic/Greek). Re-run after copy edits.
|
||||||
5. **Scenes.** `shots.scenes`: palette (fire, violet, blast, green, night, sky, gold, candy or custom), frames (one
|
5. **Scenes.** `shots.scenes`: palette (fire, violet, blast, green, night, sky, gold, candy or custom), frames (one
|
||||||
front phone + optional back phones with x / dy / scale / rotate), badge slots (y, side, icon, hot, stars).
|
front phone + optional back phones with x / dy / scale / rotate), badge slots (y, side, icon, hot, stars).
|
||||||
6. **Render.** `crt-ship shots render --lang en` first, review `store/renders/en/sheet.png` (contact sheet), then
|
6. **Render.** `storebound shots render --lang en` first, review `store/renders/en/sheet.png` (contact sheet), then
|
||||||
all languages in the background: `crt-ship shots render > .crt-ship/render.log 2>&1 &`.
|
all languages in the background: `storebound shots render > .storebound/render.log 2>&1 &`.
|
||||||
7. **JPEG for Play.** `crt-ship shots jpeg` (q92, about 4x smaller than PNG; App Store stays PNG).
|
7. **JPEG for Play.** `storebound shots jpeg` (q92, about 4x smaller than PNG; App Store stays PNG).
|
||||||
8. **Upload.** `crt-ship play images` and `crt-ship apple screenshots` (both idempotent, background + log).
|
8. **Upload.** `storebound play images` and `storebound apple screenshots` (both idempotent, background + log).
|
||||||
|
|
||||||
## Gotchas
|
## Gotchas
|
||||||
- Output is 24-bit RGB PNG: Play rejects alpha / palette PNGs, Apple rejects alpha.
|
- Output is 24-bit RGB PNG: Play rejects alpha / palette PNGs, Apple rejects alpha.
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
App Store Connect > your app > App Privacy. **Web UI only, there is no API.** Fill it from this table, then press
|
App Store Connect > your app > App Privacy. **Web UI only, there is no API.** Fill it from this table, then press
|
||||||
**Publish** at the top of the App Privacy page (saving alone does not publish it, and review checks the published one).
|
**Publish** at the top of the App Privacy page (saving alone does not publish it, and review checks the published one).
|
||||||
Keep it consistent with the privacy policy and the Play Data safety answers (`dataSafety` in `crt-ship.config.ts`).
|
Keep it consistent with the privacy policy and the Play Data safety answers (`dataSafety` in `storebound.config.ts`).
|
||||||
|
|
||||||
Typical free-to-play game: analytics SDK + ad mediation (with ATT) + optional server backup, no accounts.
|
Typical free-to-play game: analytics SDK + ad mediation (with ATT) + optional server backup, no accounts.
|
||||||
|
|
||||||
|
|
@ -29,5 +29,5 @@ reporter).
|
||||||
Per data type the UI asks, in order: purposes (checkboxes) > "Is this data linked to the user's identity?" >
|
Per data type the UI asks, in order: purposes (checkboxes) > "Is this data linked to the user's identity?" >
|
||||||
"Do you or your third-party partners use this data for tracking purposes?".
|
"Do you or your third-party partners use this data for tracking purposes?".
|
||||||
|
|
||||||
Privacy policy URL: App Information > Privacy Policy URL (set by `crt-ship apple listing`). Privacy choices URL:
|
Privacy policy URL: App Information > Privacy Policy URL (set by `storebound apple listing`). Privacy choices URL:
|
||||||
optional, leave empty unless you have a page for it.
|
optional, leave empty unless you have a page for it.
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
# Example Game · App Store listing copy
|
# Example Game · App Store listing copy
|
||||||
|
|
||||||
Source for `crt-ship apple listing`. One `## <ASC locale>` section per locale (the first word is the locale code:
|
Source for `storebound apple listing`. One `## <ASC locale>` section per locale (the first word is the locale code:
|
||||||
`en-US`, `tr`, `de-DE`, `ja`, `zh-Hans`, `ar-SA`, ...), one fenced block per `### <field>`, field names exactly:
|
`en-US`, `tr`, `de-DE`, `ja`, `zh-Hans`, `ar-SA`, ...), one fenced block per `### <field>`, field names exactly:
|
||||||
`name` (optional, defaults to `app.name`), `subtitle` (30), `promotionalText` (170), `keywords` (100 bytes, comma
|
`name` (optional, defaults to `app.name`), `subtitle` (30), `promotionalText` (170), `keywords` (100 bytes, comma
|
||||||
separated, no spaces after commas, do not repeat the app name), `description` (4000), `whatsNew` (optional; not allowed
|
separated, no spaces after commas, do not repeat the app name), `description` (4000), `whatsNew` (optional; not allowed
|
||||||
on the first version). Shared values (privacy policy, support and marketing URL) come from `crt-ship.config.ts`.
|
on the first version). Shared values (privacy policy, support and marketing URL) come from `storebound.config.ts`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@
|
||||||
Answers for a typical single-player free-to-play game with ads (mediation) and in-app purchases, no accounts, no chat,
|
Answers for a typical single-player free-to-play game with ads (mediation) and in-app purchases, no accounts, no chat,
|
||||||
no user-generated content, general audience 13+. Change what does not match your game. Everything marked **UI** has no
|
no user-generated content, general audience 13+. Change what does not match your game. Everything marked **UI** has no
|
||||||
API: Play Console > your app > Policy and programs > **App content** (or Dashboard > "Set up your app"), and App Store
|
API: Play Console > your app > Policy and programs > **App content** (or Dashboard > "Set up your app"), and App Store
|
||||||
Connect for Apple. Data safety (Play) has an API: `crt-ship play data-safety`.
|
Connect for Apple. Data safety (Play) has an API: `storebound play data-safety`.
|
||||||
|
|
||||||
## Google Play · App content (UI)
|
## Google Play · App content (UI)
|
||||||
|
|
||||||
|
|
@ -16,7 +16,7 @@ Connect for Apple. Data safety (Play) has an API: `crt-ship play data-safety`.
|
||||||
| Target audience and content | 13-15, 16-17, 18 and over; "Could your app unintentionally appeal to children?" No (only if true) |
|
| Target audience and content | 13-15, 16-17, 18 and over; "Could your app unintentionally appeal to children?" No (only if true) |
|
||||||
| News app | No |
|
| News app | No |
|
||||||
| COVID-19 contact tracing / status | No |
|
| COVID-19 contact tracing / status | No |
|
||||||
| Data safety | `crt-ship play data-safety` (then check the summary in the Console) |
|
| Data safety | `storebound play data-safety` (then check the summary in the Console) |
|
||||||
| Government apps | No |
|
| Government apps | No |
|
||||||
| Financial features | My app doesn't provide any financial features |
|
| Financial features | My app doesn't provide any financial features |
|
||||||
| Health apps | No health features |
|
| Health apps | No health features |
|
||||||
|
|
@ -27,7 +27,7 @@ Connect for Apple. Data safety (Play) has an API: `crt-ship play data-safety`.
|
||||||
Families / Designed for Families: only if you really target children; it changes the ad SDK setup (certified networks,
|
Families / Designed for Families: only if you really target children; it changes the ad SDK setup (certified networks,
|
||||||
no ad id). If you leave children out, the policy and the ad mediation must say "not directed at children" too.
|
no ad id). If you leave children out, the policy and the ad mediation must say "not directed at children" too.
|
||||||
|
|
||||||
## IARC content rating (Play UI; Apple has its own form, `crt-ship apple appinfo`)
|
## IARC content rating (Play UI; Apple has its own form, `storebound apple appinfo`)
|
||||||
|
|
||||||
Category: Game. Typical answers for a non-violent casual game:
|
Category: Game. Typical answers for a non-violent casual game:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Example Game · Google Play listing copy
|
# Example Game · Google Play listing copy
|
||||||
|
|
||||||
Source for `crt-ship play listing` (title, short + full description) and `crt-ship play release` (release notes).
|
Source for `storebound play listing` (title, short + full description) and `storebound play release` (release notes).
|
||||||
Rules the parser follows:
|
Rules the parser follows:
|
||||||
- every `## ...` section with a `<!-- play: <codes> -->` line is a listing; one section can serve several Play codes
|
- every `## ...` section with a `<!-- play: <codes> -->` line is a listing; one section can serve several Play codes
|
||||||
(`<!-- play: es-ES, es-419 -->`)
|
(`<!-- play: es-ES, es-419 -->`)
|
||||||
|
|
|
||||||
|
|
@ -6,7 +6,7 @@
|
||||||
<title>Privacy Policy · Example Studio</title>
|
<title>Privacy Policy · Example Studio</title>
|
||||||
<!--
|
<!--
|
||||||
One studio-wide privacy policy for every game, with a per-game services table. Host it at a stable URL
|
One studio-wide privacy policy for every game, with a per-game services table. Host it at a stable URL
|
||||||
(https://example.com/privacy) and use that URL in both store listings, in crt-ship.config.ts and inside each game
|
(https://example.com/privacy) and use that URL in both store listings, in storebound.config.ts and inside each game
|
||||||
(Settings > Privacy; App Store guideline 5.1.1). Replace every "Example" value and remove services you do not use.
|
(Settings > Privacy; App Store guideline 5.1.1). Replace every "Example" value and remove services you do not use.
|
||||||
Update the date and the table whenever a game starts collecting something new, then the store declarations.
|
Update the date and the table whenever a game starts collecting something new, then the store declarations.
|
||||||
This is a template, not legal advice.
|
This is a template, not legal advice.
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
// crt-ship config for one game. Everything game-specific lives here; credentials NEVER do (they go in env vars or
|
// storebound config for one game. Everything game-specific lives here; credentials NEVER do (they go in env vars or
|
||||||
// .crt-ship/credentials.json, which must stay gitignored). Paths are relative to this file.
|
// .storebound/credentials.json, which must stay gitignored). Paths are relative to this file.
|
||||||
// The type import is optional: it only works when crt-ship is installed in the project (bun add -d <repo url>).
|
// The type import is optional: it only works when storebound is installed in the project (bun add -d <repo url>).
|
||||||
import type { ShipConfig } from 'crt-ship';
|
import type { ShipConfig } from 'storebound';
|
||||||
|
|
||||||
const config: ShipConfig = {
|
const config: ShipConfig = {
|
||||||
app: {
|
app: {
|
||||||
|
|
@ -16,7 +16,7 @@ const tpl = (f: string) => readFileSync(join(T, f), 'utf8');
|
||||||
|
|
||||||
describe('config', () => {
|
describe('config', () => {
|
||||||
test('template config loads and validates', async () => {
|
test('template config loads and validates', async () => {
|
||||||
const l = await loadConfig(join(T, 'crt-ship.config.ts'));
|
const l = await loadConfig(join(T, 'storebound.config.ts'));
|
||||||
expect(l.config.play?.packageName).toBe('com.example.game');
|
expect(l.config.play?.packageName).toBe('com.example.game');
|
||||||
expect(l.resolve('store/x.md')).toBe(join(T, 'store/x.md'));
|
expect(l.resolve('store/x.md')).toBe(join(T, 'store/x.md'));
|
||||||
});
|
});
|
||||||
|
|
@ -143,7 +143,7 @@ describe('screenshots', () => {
|
||||||
expect(scriptFont('hi', 'नमस्ते')!.slug).toBe('devanagari');
|
expect(scriptFont('hi', 'नमस्ते')!.slug).toBe('devanagari');
|
||||||
});
|
});
|
||||||
test('template copy fits the template scenes', async () => {
|
test('template copy fits the template scenes', async () => {
|
||||||
const { config } = await loadConfig(join(T, 'crt-ship.config.ts'));
|
const { config } = await loadConfig(join(T, 'storebound.config.ts'));
|
||||||
expect(validateCopy(copy, config.shots!, config.languages.map(l => l.id))).toEqual([]);
|
expect(validateCopy(copy, config.shots!, config.languages.map(l => l.id))).toEqual([]);
|
||||||
const broken = { en: { ...copy.en, play: { ...copy.en!.play!, badges: [['a'], ['b'], ['c']] } } } as CopyFile;
|
const broken = { en: { ...copy.en, play: { ...copy.en!.play!, badges: [['a'], ['b'], ['c']] } } } as CopyFile;
|
||||||
expect(validateCopy(broken, config.shots!, ['en', 'de']).join('\n')).toMatch(/3 badges but the scene has 2 slots[\s\S]*de: no copy/);
|
expect(validateCopy(broken, config.shots!, ['en', 'de']).join('\n')).toMatch(/3 badges but the scene has 2 slots[\s\S]*de: no copy/);
|
||||||
|
|
|
||||||
|
|
@ -11,5 +11,5 @@
|
||||||
"noEmit": true,
|
"noEmit": true,
|
||||||
"skipLibCheck": true
|
"skipLibCheck": true
|
||||||
},
|
},
|
||||||
"include": ["cli", "tests", "templates/crt-ship.config.ts"]
|
"include": ["cli", "tests", "templates/storebound.config.ts"]
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue