0.4.0: changelog, version, README (journey, commands, skills, MCP, safety, FAQ, roadmap), agent rules, adapters
Owner-only steps in docs/agents-core.md now include Beta App Review, tester invitations, review replies, price changes and store experiments; personal data stays in .storebound/. README: live-game journey row, TestFlight and After launch command tables, four new skills, MCP 2026-07-28, unverified list. SECURITY: new endpoints.
This commit is contained in:
parent
d3cc7e43d4
commit
79fea16016
14 changed files with 242 additions and 90 deletions
|
|
@ -9,7 +9,7 @@
|
||||||
"name": "storebound",
|
"name": "storebound",
|
||||||
"source": ".",
|
"source": ".",
|
||||||
"description": "Take a mobile game from nothing to Submit for review on both stores: skills for every store step and questionnaire plus the storebound CLI and MCP server.",
|
"description": "Take a mobile game from nothing to Submit for review on both stores: skills for every store step and questionnaire plus the storebound CLI and MCP server.",
|
||||||
"version": "0.3.1",
|
"version": "0.4.0",
|
||||||
"category": "development",
|
"category": "development",
|
||||||
"tags": [
|
"tags": [
|
||||||
"mobile",
|
"mobile",
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "storebound",
|
"name": "storebound",
|
||||||
"version": "0.3.1",
|
"version": "0.4.0",
|
||||||
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, release management. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "CRTkafa"
|
"name": "CRTkafa"
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "storebound",
|
"name": "storebound",
|
||||||
"version": "0.3.1",
|
"version": "0.4.0",
|
||||||
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, release management. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "CRTkafa"
|
"name": "CRTkafa"
|
||||||
},
|
},
|
||||||
|
|
|
||||||
|
|
@ -7,10 +7,11 @@ alwaysApply: false
|
||||||
|
|
||||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||||
|
|
||||||
1. **The owner decides public and irreversible steps.** Submitting for review, releasing a version, resuming or
|
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||||
completing a rollout, canceling a submission, deleting products or listings, accepting agreements: explain what
|
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||||
will happen and let the owner do it (or run the command only after a clear yes in chat). storebound's MCP server
|
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||||
does not offer these at all.
|
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||||
|
chat). storebound's MCP server does not offer these at all.
|
||||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||||
for real only after the owner agrees.
|
for real only after the owner agrees.
|
||||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||||
|
|
@ -22,13 +23,16 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
||||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||||
you report the progress lines, not guesses.
|
you report the progress lines, not guesses.
|
||||||
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no hidden features, no
|
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no incentives for ratings,
|
||||||
misleading screenshots, no keyword stuffing.
|
no hidden features, no misleading screenshots, no keyword stuffing.
|
||||||
|
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||||
|
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||||
|
and never ask for tester emails in chat (storebound masks them in its output).
|
||||||
|
|
||||||
## Tools
|
## Tools
|
||||||
|
|
||||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||||
- MCP: `storebound mcp` (stdio). Write tools default to `dry_run: true`; submit / release / cancel / delete are not exposed.
|
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||||
|
|
||||||
## Skills
|
## Skills
|
||||||
|
|
|
||||||
18
.github/copilot-instructions.md
vendored
18
.github/copilot-instructions.md
vendored
|
|
@ -7,10 +7,11 @@ Mobile game store releases (Google Play, App Store). Skills live in `skills/<nam
|
||||||
|
|
||||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||||
|
|
||||||
1. **The owner decides public and irreversible steps.** Submitting for review, releasing a version, resuming or
|
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||||
completing a rollout, canceling a submission, deleting products or listings, accepting agreements: explain what
|
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||||
will happen and let the owner do it (or run the command only after a clear yes in chat). storebound's MCP server
|
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||||
does not offer these at all.
|
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||||
|
chat). storebound's MCP server does not offer these at all.
|
||||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||||
for real only after the owner agrees.
|
for real only after the owner agrees.
|
||||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||||
|
|
@ -22,13 +23,16 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
||||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||||
you report the progress lines, not guesses.
|
you report the progress lines, not guesses.
|
||||||
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no hidden features, no
|
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no incentives for ratings,
|
||||||
misleading screenshots, no keyword stuffing.
|
no hidden features, no misleading screenshots, no keyword stuffing.
|
||||||
|
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||||
|
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||||
|
and never ask for tester emails in chat (storebound masks them in its output).
|
||||||
|
|
||||||
## Tools
|
## Tools
|
||||||
|
|
||||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||||
- MCP: `storebound mcp` (stdio). Write tools default to `dry_run: true`; submit / release / cancel / delete are not exposed.
|
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||||
|
|
||||||
## Skills
|
## Skills
|
||||||
|
|
|
||||||
18
AGENTS.md
18
AGENTS.md
|
|
@ -7,10 +7,11 @@ file below and follow it step by step.
|
||||||
|
|
||||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||||
|
|
||||||
1. **The owner decides public and irreversible steps.** Submitting for review, releasing a version, resuming or
|
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||||
completing a rollout, canceling a submission, deleting products or listings, accepting agreements: explain what
|
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||||
will happen and let the owner do it (or run the command only after a clear yes in chat). storebound's MCP server
|
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||||
does not offer these at all.
|
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||||
|
chat). storebound's MCP server does not offer these at all.
|
||||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||||
for real only after the owner agrees.
|
for real only after the owner agrees.
|
||||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||||
|
|
@ -22,13 +23,16 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
||||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||||
you report the progress lines, not guesses.
|
you report the progress lines, not guesses.
|
||||||
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no hidden features, no
|
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no incentives for ratings,
|
||||||
misleading screenshots, no keyword stuffing.
|
no hidden features, no misleading screenshots, no keyword stuffing.
|
||||||
|
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||||
|
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||||
|
and never ask for tester emails in chat (storebound masks them in its output).
|
||||||
|
|
||||||
## Tools
|
## Tools
|
||||||
|
|
||||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||||
- MCP: `storebound mcp` (stdio). Write tools default to `dry_run: true`; submit / release / cancel / delete are not exposed.
|
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||||
|
|
||||||
## Skills
|
## Skills
|
||||||
|
|
|
||||||
44
CHANGELOG.md
44
CHANGELOG.md
|
|
@ -1,5 +1,49 @@
|
||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
|
## 0.4.0 · 2026-10-10
|
||||||
|
|
||||||
|
Wave 2: TestFlight and life after launch (stability, reviews, prices, analytics, experiments), plus MCP 2026-07-28.
|
||||||
|
|
||||||
|
- **TestFlight through the API** (`apple testflight status | groups | testers | what-to-test | info | distribute`):
|
||||||
|
beta groups from `apple.testflight.groups` (internal / external, public links; created when missing, never changed
|
||||||
|
or deleted), testers from a CSV in `.storebound/` (the config refuses a path outside it; emails masked in every log
|
||||||
|
line; asks before Apple emails invitations; `--remove`, `--invite`), "What to Test" per locale from the App Store
|
||||||
|
listing (`### whatToTest`, else the `whats-new` notes), Test Information and Beta App Review contact / notes, a build
|
||||||
|
by its exact number to groups, Beta App Review submission behind `--submit-review` and a confirmation. Skill
|
||||||
|
`testflight`.
|
||||||
|
- **Crash and vitals health** (`health [--weekly]`): Play Developer Reporting API (user-perceived crash and ANR rates,
|
||||||
|
28-day user-weighted, worst device models, top error issues) and App Store power and performance metrics,
|
||||||
|
diagnostic signatures and TestFlight crash reports. Play's bad behavior thresholds (1.09 % crash, 0.47 % ANR, 8 % per
|
||||||
|
device, developer.android.com/topic/performance/vitals): over = blocker, from 80 % = warn, also in `validate`
|
||||||
|
(`--no-health`). Weekly Markdown report with week-over-week change in `.storebound/health/`. Skill `store-health`.
|
||||||
|
- **Review replies** (`reviews list | draft | send`): App Store customer reviews / responses and Play reviews; drafts
|
||||||
|
as Markdown in `.storebound/replies/` (never overwritten), `send` only sends drafts with `approved: true` after a
|
||||||
|
confirmation and refuses incentives, rating requests and Play replies over 350 characters. Skill `review-replies`.
|
||||||
|
- **Price sheet** (`prices export | import`): one CSV of product x store x region; diff table first, then (after a
|
||||||
|
confirmation) one App Store price schedule per changed product (base territory, every manual price, future-dated
|
||||||
|
changes with `start_date`) and the Play purchase option's regional prices (`convertRegionPrices` for regions without
|
||||||
|
a price, `--reconvert`). `store-iap-setup` skill: price sheet section.
|
||||||
|
- **Analytics snapshots** (`analytics setup | snapshot | compare`): App Store Analytics Reports API (Discovery and
|
||||||
|
Engagement + Downloads, md5-checked segments, newest processing per day) and the Play statistics exports in the
|
||||||
|
`pubsite_prod_rev_` bucket (`play.reportsBucket`); snapshots in `.storebound/analytics/`, `compare` lines them up
|
||||||
|
with the git history of the store files. Skill `store-analytics`.
|
||||||
|
- **MCP 2026-07-28**: stateless requests with per-request `_meta` and `server/discover` (supported versions,
|
||||||
|
capabilities, instructions; `resultType`, server info in every result's `_meta`, cacheable `tools/list`, -32022 for
|
||||||
|
unsupported versions); `initialize` clients (2025-11-25 and older) keep working on the same process.
|
||||||
|
- **Product Page Optimization through the API** (`apple ppo status | create | upload | start | stop`): v2 tests with
|
||||||
|
one treatment per `shots` variant, a localization per locale and the variant renders in the treatment screenshot
|
||||||
|
sets; start / stop ask first. Play store listing experiments stay console-only (documented).
|
||||||
|
- **`iphone-medium` size key** (1206 x 2622, `APP_IPHONE_61`), off by default; `apple.iphoneMedium: true` renders,
|
||||||
|
checks and uploads it. Apple scales the 6.5" set down when it is missing.
|
||||||
|
- **MCP tools**: `apple_testflight_status`, `apple_testflight_groups`, `apple_testflight_what_to_test`,
|
||||||
|
`apple_testflight_info`, `apple_testflight_distribute` (internal groups only), `health`, `health_report`,
|
||||||
|
`reviews_list`, `reviews_draft`, `prices_diff`, `prices_export`, `analytics_snapshot`, `analytics_compare`,
|
||||||
|
`analytics_setup`, `apple_ppo_status`, `apple_ppo_create`, `apple_ppo_upload`. Not exposed: tester changes and
|
||||||
|
invitations, external distribution and Beta App Review, sending replies, applying prices, starting / stopping tests.
|
||||||
|
- Agent rules: owner-only steps now include review replies, tester invitations, price changes and experiments; personal
|
||||||
|
data (tester lists, reply drafts, health and analytics files) stays in `.storebound/`.
|
||||||
|
- `apple screenshots --dry` no longer creates empty screenshot sets.
|
||||||
|
|
||||||
## 0.3.1 · 2026-10-10
|
## 0.3.1 · 2026-10-10
|
||||||
|
|
||||||
Positioning: storebound is the whole road from zero to "Submit for review", screenshots are one step of it.
|
Positioning: storebound is the whole road from zero to "Submit for review", screenshots are one step of it.
|
||||||
|
|
|
||||||
18
GEMINI.md
18
GEMINI.md
|
|
@ -6,10 +6,11 @@ This extension ships Agent Skills (skills/) and the storebound MCP server for mo
|
||||||
|
|
||||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||||
|
|
||||||
1. **The owner decides public and irreversible steps.** Submitting for review, releasing a version, resuming or
|
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||||
completing a rollout, canceling a submission, deleting products or listings, accepting agreements: explain what
|
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||||
will happen and let the owner do it (or run the command only after a clear yes in chat). storebound's MCP server
|
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||||
does not offer these at all.
|
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||||
|
chat). storebound's MCP server does not offer these at all.
|
||||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||||
for real only after the owner agrees.
|
for real only after the owner agrees.
|
||||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||||
|
|
@ -21,13 +22,16 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
||||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||||
you report the progress lines, not guesses.
|
you report the progress lines, not guesses.
|
||||||
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no hidden features, no
|
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no incentives for ratings,
|
||||||
misleading screenshots, no keyword stuffing.
|
no hidden features, no misleading screenshots, no keyword stuffing.
|
||||||
|
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||||
|
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||||
|
and never ask for tester emails in chat (storebound masks them in its output).
|
||||||
|
|
||||||
## Tools
|
## Tools
|
||||||
|
|
||||||
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.
|
||||||
- MCP: `storebound mcp` (stdio). Write tools default to `dry_run: true`; submit / release / cancel / delete are not exposed.
|
- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.
|
||||||
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).
|
||||||
|
|
||||||
## Skills
|
## Skills
|
||||||
|
|
|
||||||
161
README.md
161
README.md
|
|
@ -3,11 +3,11 @@
|
||||||
**Website: [storebound.dev](https://storebound.dev)**
|
**Website: [storebound.dev](https://storebound.dev)**
|
||||||
|
|
||||||
[](LICENSE)
|
[](LICENSE)
|
||||||
[](CHANGELOG.md)
|
[](CHANGELOG.md)
|
||||||
[](https://bun.sh)
|
[](https://bun.sh)
|
||||||
[](package.json)
|
[](package.json)
|
||||||
[](skills)
|
[](skills)
|
||||||
[](#mcp-server)
|
[](#mcp-server)
|
||||||
|
|
||||||
**Take a mobile game from nothing to "Submit for review" on Google Play and the App Store: app records, listings in
|
**Take a mobile game from nothing to "Submit for review" on Google Play and the App Store: app records, listings in
|
||||||
every language, in-app products with regional prices, every questionnaire, privacy, icons, screenshots and previews,
|
every language, in-app products with regional prices, every questionnaire, privacy, icons, screenshots and previews,
|
||||||
|
|
@ -23,6 +23,10 @@ It is not a product: no dashboard, no account, no telemetry. A small Bun CLI tha
|
||||||
Agent Skills that walk your AI coding tool (or you) through the parts that are still console clicks, and an MCP server
|
Agent Skills that walk your AI coding tool (or you) through the parts that are still console clicks, and an MCP server
|
||||||
so agents can call the CLI safely. **storebound never presses Submit, Release or Publish for you.**
|
so agents can call the CLI safely. **storebound never presses Submit, Release or Publish for you.**
|
||||||
|
|
||||||
|
It keeps going after launch: TestFlight groups and testers, crash and ANR vitals against the store thresholds, review
|
||||||
|
replies you approve before they go out, prices for many products and regions from one CSV, store analytics next to
|
||||||
|
your listing changes, and App Store product page tests from your screenshot variants.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
## The journey
|
## The journey
|
||||||
|
|
@ -41,17 +45,18 @@ your own click.
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|
|
||||||
| 1 | **Set up** | `init` (config, `store/*.md`, declarations and privacy templates), `install --agent <tool>`, `check` | Play: service account + API access invite; App Store: API team key (`play-first-release`, `appstore-first-release`) | developer accounts; Paid Applications agreement, banking and tax; Play payments profile |
|
| 1 | **Set up** | `init` (config, `store/*.md`, declarations and privacy templates), `install --agent <tool>`, `check` | Play: service account + API access invite; App Store: API team key (`play-first-release`, `appstore-first-release`) | developer accounts; Paid Applications agreement, banking and tax; Play payments profile |
|
||||||
| 2 | **App records and bundle id** | `apple bundle` registers the bundle id, `apple status` finds the app record | App Store Connect > New App (no API); Play Console > Create app; the very first AAB upload when Play needs it from the Console | the declarations you accept when creating the Play app |
|
| 2 | **App records and bundle id** | `apple bundle` registers the bundle id, `apple status` finds the app record | App Store Connect > New App (no API); Play Console > Create app; the very first AAB upload when Play needs it from the Console | the declarations you accept when creating the Play app |
|
||||||
| 3 | **Builds** | `play next-version-code`, `play release app.aab` (internal track), `apple next-build`, `xcodebuild` archive + upload with the API key (the skill has the commands), `apple encryption` | TestFlight internal group, internal testers (`appstore-first-release`, `play-first-release`) | |
|
| 3 | **Builds and testers** | `play next-version-code`, `play release app.aab` (internal track), `apple next-build`, `xcodebuild` archive + upload with the API key (the skill has the commands), `apple encryption`, `apple testflight groups / what-to-test / info / distribute` (internal groups) | Play internal testers list, Apple sandbox testers (`play-first-release`, `testflight`) | `apple testflight testers` (Apple emails the invitations), external groups and Beta App Review (`distribute --submit-review`) |
|
||||||
| 4 | **In-app products** | `play products` (regional prices from USD + your overrides, activated), `apple iap` (localizations, price schedule, availability), `apple iap-review` (review screenshots) | Play license testers, Apple sandbox testers, "Add for Review" of the first IAPs into the version's submission (`store-iap-setup`) | |
|
| 4 | **In-app products** | `play products` (regional prices from USD + your overrides, activated), `apple iap` (localizations, price schedule, availability), `apple iap-review` (review screenshots) | Play license testers, Apple sandbox testers, "Add for Review" of the first IAPs into the version's submission (`store-iap-setup`) | |
|
||||||
| 5 | **Store listings, every language** | `play listing` (title, short / full description, contact email + website, promo video URL), `apple listing --version x --build N` (name, subtitle, description, keywords, promo text, URLs, privacy URL, manual release), `whats-new`, `check` (limits), `check --aso` | Play store settings: category and tags (`play-first-release`) | |
|
| 5 | **Store listings, every language** | `play listing` (title, short / full description, contact email + website, promo video URL), `apple listing --version x --build N` (name, subtitle, description, keywords, promo text, URLs, privacy URL, manual release), `whats-new`, `check` (limits), `check --aso` | Play store settings: category and tags (`play-first-release`) | |
|
||||||
| 6 | **Play questionnaires** | `play data-safety`: the whole Data safety form from `dataSafety` in the config (CSV import through the API) | Policy and programs > App content, answers prepared in `store/declarations.md` (`store-declarations`): privacy policy, app access / sign-in details, ads, content rating (IARC), target audience and content, advertising ID, news, government, financial and health features; Data safety summary check | the answers themselves are your statements: the agent asks when the code does not prove them |
|
| 6 | **Play questionnaires** | `play data-safety`: the whole Data safety form from `dataSafety` in the config (CSV import through the API) | Policy and programs > App content, answers prepared in `store/declarations.md` (`store-declarations`): privacy policy, app access / sign-in details, ads, content rating (IARC), target audience and content, advertising ID, news, government, financial and health features; Data safety summary check | the answers themselves are your statements: the agent asks when the code does not prove them |
|
||||||
| 7 | **App Store questionnaires** | `apple appinfo` (categories, age rating declaration, content rights, Free price, availability), `apple encryption` (export compliance from `apple.usesNonExemptEncryption`, never guessed), `apple review-details` (contact + notes) | App Privacy nutrition labels from `store/app-privacy.md`, then **Publish** (`store-declarations`); encryption documentation when the answer is yes (`export-compliance`); the first availability record if the API refuses it | the export compliance answer (a legal statement, set once in the config) |
|
| 7 | **App Store questionnaires** | `apple appinfo` (categories, age rating declaration, content rights, Free price, availability), `apple encryption` (export compliance from `apple.usesNonExemptEncryption`, never guessed), `apple review-details` (contact + notes) | App Privacy nutrition labels from `store/app-privacy.md`, then **Publish** (`store-declarations`); encryption documentation when the answer is yes (`export-compliance`); the first availability record if the API refuses it | the export compliance answer (a legal statement, set once in the config) |
|
||||||
| 8 | **Privacy** | privacy policy page template (`init`), `privacy-manifest --ios <path>` (PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests), `validate` checks the policy URL answers | host the page, link it in both consoles and inside the game (`privacy-policy`, `privacy-manifest`) | |
|
| 8 | **Privacy** | privacy policy page template (`init`), `privacy-manifest --ios <path>` (PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests), `validate` checks the policy URL answers | host the page, link it in both consoles and inside the game (`privacy-policy`, `privacy-manifest`) | |
|
||||||
| 9 | **Icons** | `icons`: App Store 1024 without alpha, Play 512, adaptive + legacy Android launcher icons, web icons, Capacitor sources | | |
|
| 9 | **Icons** | `icons`: App Store 1024 without alpha, Play 512, adaptive + legacy Android launcher icons, web icons, Capacitor sources | | |
|
||||||
| 10 | **Screenshots and previews** | `shots capture / render / check / gallery`, `play images`, `apple screenshots`, `shots record / video`, `apple previews` (see [Store art](#store-art)) | Play store listing experiments, App Store Product Page Optimization (optional, `store-screenshots`) | uploading the promo video to YouTube |
|
| 10 | **Screenshots and previews** | `shots capture / render / check / gallery`, `play images`, `apple screenshots`, `shots record / video`, `apple previews`, `apple ppo create / upload` (App Store product page tests from `shots` variants; see [Store art](#store-art)) | Play store listing experiments (optional, `store-screenshots`) | uploading the promo video to YouTube; `apple ppo start / stop` |
|
||||||
| 11 | **Validate** | `check` (offline) and `validate` (read-only on both stores: every blocker in fix order, plus the local renders) | the UI-only items `validate` cannot see (`store-preflight` lists them) | |
|
| 11 | **Validate** | `check` (offline) and `validate` (read-only on both stores: every blocker in fix order, plus the local renders) | the UI-only items `validate` cannot see (`store-preflight` lists them) | |
|
||||||
| 12 | **Submit** | `play release --version-code N --production draft`, `apple status` | Play: countries / regions, open the production draft and save it (`play-first-release`) | **Play: Send changes for review. App Store: Submit for Review.** |
|
| 12 | **Submit** | `play release --version-code N --production draft`, `apple status` | Play: countries / regions, open the production draft and save it (`play-first-release`) | **Play: Send changes for review. App Store: Submit for Review.** |
|
||||||
| 13 | **After review** | `apple status --wait-review`, `apple release --phased on / pause`, `play rollout --halt`, reply drafts (`review-rejections`) | | releasing the approved version, resuming or completing a phased release or rollout (terminal commands that ask first, `release-management`) |
|
| 13 | **After review** | `apple status --wait-review`, `apple release --phased on / pause`, `play rollout --halt`, reply drafts (`review-rejections`) | | releasing the approved version, resuming or completing a phased release or rollout (terminal commands that ask first, `release-management`) |
|
||||||
|
| 14 | **Live game** | `health [--weekly]` (crash / ANR vitals vs Play's thresholds, App Store diagnostics; also in `validate`), `reviews list / draft`, `analytics snapshot / compare`, `prices export`, `prices import --dry`, `apple ppo status` | `store-health`, `review-replies`, `store-analytics`; Play statistics come from the reports bucket (no API) | `reviews send` (approved drafts only), `prices import` (asks first) |
|
||||||
|
|
||||||
New personal Play developer accounts also need a closed test with 12+ testers for 14 days before production; the
|
New personal Play developer accounts also need a closed test with 12+ testers for 14 days before production; the
|
||||||
`play-first-release` skill covers it.
|
`play-first-release` skill covers it.
|
||||||
|
|
@ -59,15 +64,19 @@ New personal Play developer accounts also need a closed test with 12+ testers fo
|
||||||
### API or console, honestly
|
### API or console, honestly
|
||||||
|
|
||||||
- **Through the API** (storebound does it): bundle id, builds on tracks, versions and build selection, listings in
|
- **Through the API** (storebound does it): bundle id, builds on tracks, versions and build selection, listings in
|
||||||
every language, graphics, screenshots, app previews, in-app products and prices, Play Data safety, Apple age rating,
|
every language, graphics, screenshots, app previews, in-app products and prices (also from one CSV), Play Data
|
||||||
categories, content rights, price and availability, export compliance answer, App Review details, phased release
|
safety, Apple age rating, categories, content rights, price and availability, export compliance answer, App Review
|
||||||
and staged rollout.
|
details, phased release and staged rollout, TestFlight groups / testers / What to Test / Test Information, crash and
|
||||||
|
ANR vitals and App Store diagnostics, review replies, App Store analytics reports, App Store Product Page
|
||||||
|
Optimization tests.
|
||||||
- **Console only** (no public API; the skill + your agent's browser, or you): creating the App Store Connect app record
|
- **Console only** (no public API; the skill + your agent's browser, or you): creating the App Store Connect app record
|
||||||
and the Play app, Play App content (IARC content rating, target audience, ads, advertising ID, app access,
|
and the Play app, Play App content (IARC content rating, target audience, ads, advertising ID, app access,
|
||||||
government / financial / health / news), Play category and tags, Play countries, App Privacy labels and their
|
government / financial / health / news), Play category and tags, Play countries, App Privacy labels and their
|
||||||
Publish, TestFlight groups, adding first IAPs to the submission, store experiments.
|
Publish, adding first IAPs to the submission, Play store listing experiments, test results of both stores' experiments.
|
||||||
|
Play store statistics have no API either: storebound reads the monthly exports from your Play reports bucket.
|
||||||
- **Only you**: agreements, banking and tax, and the final Send for review / Submit for Review. Releases and
|
- **Only you**: agreements, banking and tax, and the final Send for review / Submit for Review. Releases and
|
||||||
rollouts after approval too. None of these is an MCP tool.
|
rollouts after approval, Beta App Review, tester invitations, sending review replies, applying price changes and
|
||||||
|
starting / stopping a product page test too. None of these is an MCP tool; the terminal commands ask first.
|
||||||
|
|
||||||
## 5-minute quick start
|
## 5-minute quick start
|
||||||
|
|
||||||
|
|
@ -94,9 +103,20 @@ bunx storebound shots capture && bunx storebound shots render && bunx storebound
|
||||||
bunx storebound validate # read-only: what still blocks a submission, per store, in fix order
|
bunx storebound validate # read-only: what still blocks a submission, per store, in fix order
|
||||||
```
|
```
|
||||||
|
|
||||||
|
After launch:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
bunx storebound apple testflight what-to-test --build 42 --dry # then distribute --build 42 --group Team
|
||||||
|
bunx storebound health --weekly # vitals + diagnostics, .storebound/health/<date>.md
|
||||||
|
bunx storebound reviews draft # reply drafts in .storebound/replies/, then reviews send
|
||||||
|
bunx storebound prices export && bunx storebound prices import --dry
|
||||||
|
bunx storebound analytics snapshot && bunx storebound analytics compare
|
||||||
|
```
|
||||||
|
|
||||||
Or ask your agent: "take my game to Google Play and the App Store", "fill in the store questionnaires", "set up the
|
Or ask your agent: "take my game to Google Play and the App Store", "fill in the store questionnaires", "set up the
|
||||||
in-app purchases on both stores", "make store screenshots in 5 languages", "is my app ready to submit", "why was my
|
in-app purchases on both stores", "make store screenshots in 5 languages", "is my app ready to submit", "why was my
|
||||||
update rejected". The matching skill takes over.
|
update rejected", "put build 42 on TestFlight", "how are our crash rates", "answer the new reviews", "did the new
|
||||||
|
screenshots help". The matching skill takes over.
|
||||||
|
|
||||||
### Credentials (never in the repo)
|
### Credentials (never in the repo)
|
||||||
|
|
||||||
|
|
@ -174,7 +194,7 @@ run in the background with a log (`storebound shots render > .storebound/render.
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `apple bundle` | API | register the bundle id, find the app record |
|
| `apple bundle` | API | register the bundle id, find the app record |
|
||||||
| `apple listing --version x.y.z [--build N]` | API | version (manual release), the build with exactly that number, texts per locale |
|
| `apple listing --version x.y.z [--build N]` | API | version (manual release), the build with exactly that number, texts per locale |
|
||||||
| `apple screenshots [--variant b]` | API | 6.9" + 6.5" (+ 13" iPad with `apple.ipad`) per locale, MD5-idempotent |
|
| `apple screenshots [--variant b]` | API | 6.9" + 6.5" (+ 13" iPad with `apple.ipad`, + 6.3" with `apple.iphoneMedium`) per locale, MD5-idempotent |
|
||||||
| `apple previews [--poster 5]` | API | app preview videos per locale, checked first, MD5-idempotent, poster frame |
|
| `apple previews [--poster 5]` | API | app preview videos per locale, checked first, MD5-idempotent, poster frame |
|
||||||
| `apple iap` / `apple iap-review` | API | IAPs, localizations, price schedules, availability / review screenshots |
|
| `apple iap` / `apple iap-review` | API | IAPs, localizations, price schedules, availability / review screenshots |
|
||||||
| `apple appinfo` | API | categories, age rating, content rights, Free, territories |
|
| `apple appinfo` | API | categories, age rating, content rights, Free, territories |
|
||||||
|
|
@ -183,6 +203,39 @@ run in the background with a log (`storebound shots render > .storebound/render.
|
||||||
| `apple release --phased on\|pause\|resume\|complete`, `--manual-release` | API | phased release, release an approved version (resume / complete / release ask first) |
|
| `apple release --phased on\|pause\|resume\|complete`, `--manual-release` | API | phased release, release an approved version (resume / complete / release ask first) |
|
||||||
| `apple next-build` | API, read-only | next safe build number |
|
| `apple next-build` | API, read-only | next safe build number |
|
||||||
| `apple status` | API | versions, builds, IAPs, submissions; `--wait-review` (exit 0 / 1 / 7); `--cancel-submission <id>` |
|
| `apple status` | API | versions, builds, IAPs, submissions; `--wait-review` (exit 0 / 1 / 7); `--cancel-submission <id>` |
|
||||||
|
| `apple ppo status \| create --variant b \| upload --variant b` | API | Product Page Optimization test from `shots` variants: treatments, localizations, screenshot sets |
|
||||||
|
| `apple ppo start \| stop` | API | start / stop the test (asks first; a stopped test cannot be restarted) |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>TestFlight</b></summary>
|
||||||
|
|
||||||
|
| command | kind | what |
|
||||||
|
|---|---|---|
|
||||||
|
| `apple testflight status` | API, read-only | groups, testers and builds per group, recent builds with internal / external beta states |
|
||||||
|
| `apple testflight groups` | API | create the groups of `apple.testflight.groups` that are missing |
|
||||||
|
| `apple testflight testers [--csv f] [--remove] [--invite]` | API | testers from a CSV in `.storebound/` into their groups (asks first; emails masked) |
|
||||||
|
| `apple testflight what-to-test --build N` | API | "What to Test" per locale from `store/appstore.md` (`whatToTest`, else `whatsNew`) |
|
||||||
|
| `apple testflight info` | API | Beta App Description, feedback email, URLs, Beta App Review contact and notes |
|
||||||
|
| `apple testflight distribute --build N --group a,b [--submit-review]` | API | the build to groups; external groups and Beta App Review ask first |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>After launch</b></summary>
|
||||||
|
|
||||||
|
| command | kind | what |
|
||||||
|
|---|---|---|
|
||||||
|
| `health [--weekly] [--days 7]` | API, read-only | Play vitals (user-perceived crash / ANR vs 1.09 % / 0.47 %, devices, top issues), App Store metrics, diagnostics, TestFlight crashes; `--weekly` writes a Markdown report |
|
||||||
|
| `reviews list [--unanswered]` | API, read-only | recent reviews of both stores |
|
||||||
|
| `reviews draft` | API + local | one reply draft per unanswered review in `.storebound/replies/` |
|
||||||
|
| `reviews send` | API | sends drafts with `approved: true` (checks length and incentives, asks first) |
|
||||||
|
| `prices export` | API + local | current prices of every product, both stores, as `store/prices.csv` |
|
||||||
|
| `prices import [--reconvert]` | API | diff table, then (asks first) Apple price schedules incl. future-dated changes and Play regional prices |
|
||||||
|
| `analytics setup` | API | App Store analytics report request (once, Admin key) |
|
||||||
|
| `analytics snapshot [--days 28]` | API + local | impressions, page views, downloads (App Store), visitors, acquisitions, installs (Play reports bucket) -> `.storebound/analytics/` |
|
||||||
|
| `analytics compare` | local | snapshots vs the git history of the store files: before / after each listing change |
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
|
@ -256,17 +309,21 @@ navigation.
|
||||||
|---|---|
|
|---|---|
|
||||||
| `play-first-release` | Google Play from zero to "In review" |
|
| `play-first-release` | Google Play from zero to "In review" |
|
||||||
| `appstore-first-release` | App Store from API key to "Waiting for review", incl. xcodebuild with the API key |
|
| `appstore-first-release` | App Store from API key to "Waiting for review", incl. xcodebuild with the API key |
|
||||||
| `store-iap-setup` | in-app products on both stores, prices, testers, the first-IAP-with-version rule |
|
| `testflight` | beta groups, testers from a CSV that never enters git, What to Test, Test Information, Beta App Review |
|
||||||
|
| `store-iap-setup` | in-app products on both stores, prices and the price sheet CSV, testers, the first-IAP-with-version rule |
|
||||||
| `aso-basics` | keyword field, subtitle, cross-localization, Play placement without stuffing |
|
| `aso-basics` | keyword field, subtitle, cross-localization, Play placement without stuffing |
|
||||||
| `store-declarations` | every questionnaire: Play Data safety (API) and App content (IARC, target audience, ads, advertising ID, app access, government / financial / health), Apple App Privacy labels and age rating |
|
| `store-declarations` | every questionnaire: Play Data safety (API) and App content (IARC, target audience, ads, advertising ID, app access, government / financial / health), Apple App Privacy labels and age rating |
|
||||||
| `export-compliance` | encryption answer, Info.plist key, declarations; never exempt by default |
|
| `export-compliance` | encryption answer, Info.plist key, declarations; never exempt by default |
|
||||||
| `privacy-policy` | one studio-wide policy page with a per-game services table |
|
| `privacy-policy` | one studio-wide policy page with a per-game services table |
|
||||||
| `privacy-manifest` | PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests (ITMS-91053 / 91061) |
|
| `privacy-manifest` | PrivacyInfo.xcprivacy, required-reason APIs, SDK manifests (ITMS-91053 / 91061) |
|
||||||
| `app-icons` | one artwork to every icon, adaptive / legacy launcher pitfalls |
|
| `app-icons` | one artwork to every icon, adaptive / legacy launcher pitfalls |
|
||||||
| `store-screenshots` | capture from any engine, copy, fonts, render, checks, gallery, variants and store experiments, upload |
|
| `store-screenshots` | capture from any engine, copy, fonts, render, checks, gallery, variants, App Store product page tests, Play experiments, upload |
|
||||||
| `app-previews` | gameplay clips, App Store previews, Play promo video, checks, upload |
|
| `app-previews` | gameplay clips, App Store previews, Play promo video, checks, upload |
|
||||||
| `store-preflight` | run and read `check`, `check --aso`, `validate`, `privacy-manifest` before submitting |
|
| `store-preflight` | run and read `check`, `check --aso`, `validate`, `privacy-manifest` before submitting |
|
||||||
| `release-management` | updates: Apple phased + manual release, Play staged rollout, halt / pause (not a rollback), review wait |
|
| `release-management` | updates: Apple phased + manual release, Play staged rollout, halt / pause (not a rollback), review wait |
|
||||||
|
| `store-health` | crash / ANR vitals vs Play's bad behavior thresholds, App Store diagnostics, weekly report |
|
||||||
|
| `review-replies` | reply drafts, tone, no incentives, store limits, the owner approves and sends |
|
||||||
|
| `store-analytics` | App Store analytics reports, Play reports bucket, before / after listing changes |
|
||||||
| `whats-new` | player-facing release notes from git, localized, within store limits |
|
| `whats-new` | player-facing release notes from git, localized, within store limits |
|
||||||
| `review-rejections` | triage a rejection (fix / clarify / push back / appeal), reply template, the guidelines games hit |
|
| `review-rejections` | triage a rejection (fix / clarify / push back / appeal), reply template, the guidelines games hit |
|
||||||
| `ads-levelplay-checks` | LevelPlay / Unity Ads ids, adapters, app-ads.txt, SKAdNetwork, no-fill |
|
| `ads-levelplay-checks` | LevelPlay / Unity Ads ids, adapters, app-ads.txt, SKAdNetwork, no-fill |
|
||||||
|
|
@ -274,18 +331,23 @@ navigation.
|
||||||
|
|
||||||
## MCP server
|
## MCP server
|
||||||
|
|
||||||
`storebound mcp` speaks MCP over stdio (spec revision 2025-11-25; tools only). It runs each tool as a CLI call in the
|
`storebound mcp` speaks MCP over stdio, tools only: spec revision **2026-07-28** (stateless: `server/discover`,
|
||||||
project directory (the server's working directory, or `STOREBOUND_PROJECT`) and returns the output.
|
per-request `_meta`, `resultType`, cacheable `tools/list`) and, on the same process, clients that still open with
|
||||||
|
`initialize` (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05). It runs each tool as a CLI call in the project directory
|
||||||
|
(the server's working directory, or `STOREBOUND_PROJECT`) and returns the output.
|
||||||
|
|
||||||
- One tool per command. Read-only: `check`, `check_aso`, `validate`, `apple_status`, `apple_next_build`,
|
- One tool per command. Read-only: `check`, `check_aso`, `validate`, `health`, `reviews_list`, `prices_diff`,
|
||||||
|
`analytics_compare`, `apple_status`, `apple_next_build`, `apple_testflight_status`, `apple_ppo_status`,
|
||||||
`play_status`, `play_next_version_code`, `privacy_manifest`, `shots_check`. Local writes: `whats_new`, `icons`,
|
`play_status`, `play_next_version_code`, `privacy_manifest`, `shots_check`. Local writes: `whats_new`, `icons`,
|
||||||
`shots_capture`, `shots_render`, `shots_gallery`, `shots_record`, `shots_video`. Store writes: `play_listing`,
|
`health_report`, `reviews_draft`, `prices_export`, `analytics_snapshot`, `shots_capture`, `shots_render`,
|
||||||
`play_images`, `play_products`, `play_data_safety`, `play_release_testing`, `apple_bundle`, `apple_iap`,
|
`shots_gallery`, `shots_record`, `shots_video`. Store writes: `play_listing`, `play_images`, `play_products`,
|
||||||
`apple_iap_review`, `apple_listing`, `apple_screenshots`, `apple_previews`, `apple_appinfo`,
|
`play_data_safety`, `play_release_testing`, `apple_bundle`, `apple_iap`, `apple_iap_review`, `apple_listing`,
|
||||||
`apple_review_details`, `apple_encryption`, `apple_phased_release`.
|
`apple_screenshots`, `apple_previews`, `apple_appinfo`, `apple_review_details`, `apple_encryption`,
|
||||||
|
`apple_phased_release`, `apple_testflight_groups`, `apple_testflight_what_to_test`, `apple_testflight_info`,
|
||||||
|
`apple_testflight_distribute` (internal groups only), `apple_ppo_create`, `apple_ppo_upload`, `analytics_setup`.
|
||||||
- Annotations say what is read-only, destructive (replaces data), idempotent and network-bound.
|
- Annotations say what is read-only, destructive (replaces data), idempotent and network-bound.
|
||||||
- No MCP SDK: about 150 lines of newline-delimited JSON-RPC (initialize, ping, tools/list, tools/call, cancellation),
|
- No MCP SDK: a small newline-delimited JSON-RPC server (server/discover, initialize, ping, tools/list, tools/call,
|
||||||
so storebound keeps zero runtime dependencies.
|
cancellation), so storebound keeps zero runtime dependencies.
|
||||||
|
|
||||||
Manual config for a tool that `install` does not know: command `bunx` with args `["storebound", "mcp"]` (or the
|
Manual config for a tool that `install` does not know: command `bunx` with args `["storebound", "mcp"]` (or the
|
||||||
absolute path of `bin/storebound` plus `mcp`).
|
absolute path of `bin/storebound` plus `mcp`).
|
||||||
|
|
@ -293,12 +355,17 @@ absolute path of `bin/storebound` plus `mcp`).
|
||||||
## Safety model
|
## Safety model
|
||||||
|
|
||||||
- **Credentials** live in env vars or the gitignored `.storebound/credentials.json`, never in the config or the repo.
|
- **Credentials** live in env vars or the gitignored `.storebound/credentials.json`, never in the config or the repo.
|
||||||
storebound only talks to the official store APIs (plus Google Fonts and your own URLs); see [SECURITY.md](SECURITY.md).
|
storebound only talks to the official store APIs (plus Google Fonts, your own Play reports bucket and your own URLs);
|
||||||
|
see [SECURITY.md](SECURITY.md).
|
||||||
- **Dry run everywhere.** Every write command takes `--dry`; every MCP write tool has `dry_run`, **default true**.
|
- **Dry run everywhere.** Every write command takes `--dry`; every MCP write tool has `dry_run`, **default true**.
|
||||||
- **Nothing public or irreversible through an agent.** Submitting for review, releasing a version, production
|
- **Nothing public or irreversible through an agent.** Submitting for review (App Review and Beta App Review),
|
||||||
releases, resuming or completing a rollout or phased release, canceling a submission and deleting are not MCP
|
releasing a version, production releases, resuming or completing a rollout or phased release, canceling a
|
||||||
tools. They stay terminal commands that ask for confirmation, and the skills tell every agent to ask the owner
|
submission, deleting, inviting or removing testers, sending review replies, applying prices and starting or
|
||||||
|
stopping a product page test are not MCP tools. They stay terminal commands that ask for confirmation, and the skills tell every agent to ask the owner
|
||||||
first ([docs/agents-core.md](docs/agents-core.md)).
|
first ([docs/agents-core.md](docs/agents-core.md)).
|
||||||
|
- **Personal data stays local.** Tester lists, reply drafts, health reports and analytics snapshots live in the
|
||||||
|
gitignored `.storebound/`; tester emails are masked in every log line, and the config refuses a tester CSV path
|
||||||
|
outside `.storebound/`.
|
||||||
- **Idempotent writes.** Re-running a command converges (MD5 checks for screenshots and previews, one Play edit per
|
- **Idempotent writes.** Re-running a command converges (MD5 checks for screenshots and previews, one Play edit per
|
||||||
language), so a failed upload is fixed by running it again.
|
language), so a failed upload is fixed by running it again.
|
||||||
- **Simulators and emulators**: storebound shuts down only a simulator it booted itself and never boots, wipes or
|
- **Simulators and emulators**: storebound shuts down only a simulator it booted itself and never boots, wipes or
|
||||||
|
|
@ -335,21 +402,25 @@ zero runtime dependencies. It needs Bun installed (it does not run on plain Node
|
||||||
**Does it upload my video to YouTube?** No. Play only takes a YouTube URL, and uploading to YouTube needs your Google
|
**Does it upload my video to YouTube?** No. Play only takes a YouTube URL, and uploading to YouTube needs your Google
|
||||||
account; `shots video` makes the file, you upload it and paste the URL into `play.video`.
|
account; `shots video` makes the file, you upload it and paste the URL into `play.video`.
|
||||||
|
|
||||||
**Can it run store experiments for me?** Not yet. It renders and checks the variant images; Play store listing
|
**Can it run store experiments for me?** On the App Store, mostly: `apple ppo create / upload` builds a Product Page
|
||||||
experiments are Console-only, and App Store Product Page Optimization tests are set up in App Store Connect.
|
Optimization test from your `shots` variants (treatments, locales, screenshots) and you start it (`apple ppo start`
|
||||||
|
asks first). Results per treatment are only shown in App Store Connect. Play store listing experiments have no API:
|
||||||
|
storebound renders and checks the variant images, you set the experiment up in Play Console.
|
||||||
|
|
||||||
|
**Does it answer reviews by itself?** No. It drafts one file per review, your agent helps write the replies, and only
|
||||||
|
the drafts you mark `approved: true` are sent, by you, after a confirmation. Replies that offer something for a rating
|
||||||
|
are refused.
|
||||||
|
|
||||||
## Roadmap
|
## Roadmap
|
||||||
|
|
||||||
Wave 2, roughly in this order:
|
Wave 2 (TestFlight, vitals, review replies, price sheets, analytics, MCP 2026-07-28, Product Page Optimization) shipped
|
||||||
|
in 0.4.0. Next, roughly in this order:
|
||||||
|
|
||||||
- TestFlight through the API: beta groups, testers, build distribution, "What to Test".
|
- Subscriptions (groups, levels, introductory offers) on both stores from the same product list.
|
||||||
- Crash and vitals reports: Play Android vitals, App Store Connect diagnostics, in `validate` and a weekly summary.
|
- App Store custom product pages and in-app events from the same copy and renders.
|
||||||
- Review replies on both stores, drafted by the agent, sent only after you approve.
|
- Play store listing experiments and their results, as soon as Google offers an API.
|
||||||
- Prices from a CSV for many products and regions at once.
|
- App preview treatments and alternate icons in Product Page Optimization tests.
|
||||||
- Store analytics snapshots (installs, conversion) next to the listing changes and experiments.
|
- The iPhone Duo screenshot classes Apple lists for apps built with the iOS 27.1 SDK (required from April 2027).
|
||||||
- MCP 2026-07-28 (stateless revision: `server/discover`, per-request `_meta`).
|
|
||||||
- Product Page Optimization through the App Store Connect API, and a medium iPhone size key if Apple starts to
|
|
||||||
require it strictly.
|
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
|
|
@ -372,7 +443,16 @@ Checked against each tool's own docs in October 2026:
|
||||||
`install --agent gemini` is not verified (the extension route is).
|
`install --agent gemini` is not verified (the extension route is).
|
||||||
- **Windsurf**: the current docs name `~/.config/devin/mcp_config.json`; `install` keeps using
|
- **Windsurf**: the current docs name `~/.config/devin/mcp_config.json`; `install` keeps using
|
||||||
`~/.codeium/windsurf/mcp_config.json` when that file already exists (older installs).
|
`~/.codeium/windsurf/mcp_config.json` when that file already exists (older installs).
|
||||||
- **MCP**: built for 2025-11-25 (also answers clients asking for 2025-06-18 / 2025-03-26 / 2024-11-05).
|
- **MCP**: built for 2026-07-28 (final, modelcontextprotocol.io) and dual-era: `initialize` clients get 2025-11-25
|
||||||
|
(or 2025-06-18 / 2025-03-26 / 2024-11-05). Tested with both handshakes on one stdio process, not yet against every
|
||||||
|
client listed above.
|
||||||
|
- **Not verified against a live account yet** (no credentials during development; request builders are tested with
|
||||||
|
fixtures from the official docs): the scale of the Play Reporting API rates (read as fractions, 0.0109 = 1.09 %),
|
||||||
|
the App Store review reply limit (5970 characters is commonly reported; Apple documents none, storebound only
|
||||||
|
warns), the TestFlight "What to Test" limit (4000 assumed), whether an analytics segment checksum covers the gzip
|
||||||
|
file or its content (both are accepted), that a new App Store price schedule replaces the old one (Apple's example
|
||||||
|
implies it), stopping a Product Page Optimization test with `started: false`, and `APP_IPHONE_61` for the 6.3"
|
||||||
|
iPhone set.
|
||||||
- **Apple IAP description**: 45 characters (App Store Connect Help, "In-app purchase information"); an older App Store
|
- **Apple IAP description**: 45 characters (App Store Connect Help, "In-app purchase information"); an older App Store
|
||||||
marketing page says 55. storebound checks 45.
|
marketing page says 55. storebound checks 45.
|
||||||
|
|
||||||
|
|
@ -402,7 +482,8 @@ Some skills were sparked by other people's open work. I wrote my own text; the i
|
||||||
- [rshankras/claude-code-apple-skills](https://github.com/rshankras/claude-code-apple-skills) (MIT): Apple platform and
|
- [rshankras/claude-code-apple-skills](https://github.com/rshankras/claude-code-apple-skills) (MIT): Apple platform and
|
||||||
App Store topic ideas.
|
App Store topic ideas.
|
||||||
|
|
||||||
Built with Bun and plain `fetch` against the Google Play Developer API v3 and the App Store Connect API. Screenshot
|
Built with Bun and plain `fetch` against the Google Play Developer API v3, the Play Developer Reporting API and the App
|
||||||
|
Store Connect API. Screenshot
|
||||||
fonts come from Google Fonts at render time (Noto, Lilita One, Montserrat; SIL Open Font License 1.1). Not affiliated
|
fonts come from Google Fonts at render time (Noto, Lilita One, Montserrat; SIL Open Font License 1.1). Not affiliated
|
||||||
with Google or Apple.
|
with Google or Apple.
|
||||||
|
|
||||||
|
|
|
||||||
13
SECURITY.md
13
SECURITY.md
|
|
@ -14,10 +14,15 @@ published.
|
||||||
- Credentials come only from environment variables or `.storebound/credentials.json` in your project; `init` adds
|
- Credentials come only from environment variables or `.storebound/credentials.json` in your project; `init` adds
|
||||||
`.storebound/` to `.gitignore`. storebound does not print them or copy them anywhere.
|
`.storebound/` to `.gitignore`. storebound does not print them or copy them anywhere.
|
||||||
- The CLI talks to the official store endpoints (`androidpublisher.googleapis.com` and `www.googleapis.com` uploads,
|
- The CLI talks to the official store endpoints (`androidpublisher.googleapis.com` and `www.googleapis.com` uploads,
|
||||||
`oauth2.googleapis.com`, `api.appstoreconnect.apple.com` and the upload URLs it hands out), Google Fonts for
|
`oauth2.googleapis.com`, `playdeveloperreporting.googleapis.com` for vitals, `storage.googleapis.com` for your own
|
||||||
`shots fonts`, your own game URL for capture / record, and your own website when `validate` checks the privacy policy URL and `app-ads.txt`.
|
Play reports bucket, `api.appstoreconnect.apple.com` and the upload / analytics download URLs it hands out), Google
|
||||||
- The MCP server exposes no tool that submits for review, releases, resumes or completes a rollout, cancels a
|
Fonts for `shots fonts`, your own game URL for capture / record, and your own website when `validate` checks the
|
||||||
submission or deletes anything; every write tool is a dry run unless `dry_run: false` is passed.
|
privacy policy URL and `app-ads.txt`.
|
||||||
|
- The MCP server exposes no tool that submits for review (App Review or Beta App Review), releases, resumes or
|
||||||
|
completes a rollout, cancels a submission, deletes anything, invites or removes testers, sends review replies,
|
||||||
|
applies prices or starts / stops a store experiment; every write tool is a dry run unless `dry_run: false` is passed.
|
||||||
|
- Personal data the CLI handles (tester emails, reviewer names in reply drafts, crash reports, analytics) stays in
|
||||||
|
the gitignored `.storebound/`; tester emails are masked in its output.
|
||||||
- `bun run ci` scrubs the repository for keys, issuer ids, emails and private names before every release.
|
- `bun run ci` scrubs the repository for keys, issuer ids, emails and private names before every release.
|
||||||
|
|
||||||
## Supported versions
|
## Supported versions
|
||||||
|
|
|
||||||
|
|
@ -2,10 +2,11 @@
|
||||||
|
|
||||||
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
These rules apply to every AI tool that uses storebound (skills, MCP server or the CLI in a terminal).
|
||||||
|
|
||||||
1. **The owner decides public and irreversible steps.** Submitting for review, releasing a version, resuming or
|
1. **The owner decides public and irreversible steps.** Submitting for review (App Review or Beta App Review),
|
||||||
completing a rollout, canceling a submission, deleting products or listings, accepting agreements: explain what
|
releasing a version, resuming or completing a rollout, canceling a submission, deleting products or listings,
|
||||||
will happen and let the owner do it (or run the command only after a clear yes in chat). storebound's MCP server
|
accepting agreements, sending review replies, inviting or removing testers, changing prices, starting or stopping
|
||||||
does not offer these at all.
|
a store experiment: explain what will happen and let the owner do it (or run the command only after a clear yes in
|
||||||
|
chat). storebound's MCP server does not offer these at all.
|
||||||
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
2. **Dry run first.** Every write command has `--dry` (MCP: `dry_run`, default true). Show the dry run, then run it
|
||||||
for real only after the owner agrees.
|
for real only after the owner agrees.
|
||||||
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
3. **Read before you write.** `storebound check` (offline) and `storebound validate` (read-only, both stores) tell you
|
||||||
|
|
@ -17,5 +18,8 @@ These rules apply to every AI tool that uses storebound (skills, MCP server or t
|
||||||
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
6. **Pick builds by explicit number.** Use the build number / versionCode you just uploaded, never "the latest".
|
||||||
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
7. **Long uploads run in the background with a log** (`storebound play images > .storebound/images.log 2>&1 &`) and
|
||||||
you report the progress lines, not guesses.
|
you report the progress lines, not guesses.
|
||||||
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no hidden features, no
|
8. **No manipulative tactics** with reviewers, players or store policies: no fake reviews, no incentives for ratings,
|
||||||
misleading screenshots, no keyword stuffing.
|
no hidden features, no misleading screenshots, no keyword stuffing.
|
||||||
|
9. **Personal data stays local.** Tester lists, review reply drafts, health reports and analytics snapshots live in
|
||||||
|
`.storebound/` (gitignored). Never put tester emails, reviewer names or crash logs into issues, docs or commits,
|
||||||
|
and never ask for tester emails in chat (storebound masks them in its output).
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "storebound",
|
"name": "storebound",
|
||||||
"version": "0.3.1",
|
"version": "0.4.0",
|
||||||
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, release management. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
"description": "From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa's own toolchain, open-sourced.",
|
||||||
"contextFileName": "GEMINI.md",
|
"contextFileName": "GEMINI.md",
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"storebound": {
|
"storebound": {
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "storebound",
|
"name": "storebound",
|
||||||
"version": "0.3.1",
|
"version": "0.4.0",
|
||||||
"description": "Take a mobile game from nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every store questionnaire, privacy, icons, screenshots and previews. One config, a Bun CLI, an MCP server and Agent Skills for your AI coding agent.",
|
"description": "Take a mobile game from nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every store questionnaire, privacy, icons, screenshots and previews, TestFlight. After launch: crash vitals, review replies, price sheets, analytics and Product Page Optimization. One config, a Bun CLI, an MCP server and Agent Skills for your AI coding agent.",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"author": "CRTkafa",
|
"author": "CRTkafa",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
|
|
@ -18,7 +18,9 @@
|
||||||
"screenshots",
|
"screenshots",
|
||||||
"claude-code-plugin",
|
"claude-code-plugin",
|
||||||
"agent-skills",
|
"agent-skills",
|
||||||
"mcp"
|
"mcp",
|
||||||
|
"testflight",
|
||||||
|
"android-vitals"
|
||||||
],
|
],
|
||||||
"bin": {
|
"bin": {
|
||||||
"storebound": "cli/index.ts"
|
"storebound": "cli/index.ts"
|
||||||
|
|
|
||||||
|
|
@ -48,7 +48,7 @@ export function generate(root: string): Map<string, string> {
|
||||||
const out = new Map<string, string>();
|
const out = new Map<string, string>();
|
||||||
const homepage = 'https://git.crt.fyi/CRT/storebound';
|
const homepage = 'https://git.crt.fyi/CRT/storebound';
|
||||||
const repository = 'https://git.crt.fyi/CRT/storebound.git';
|
const repository = 'https://git.crt.fyi/CRT/storebound.git';
|
||||||
const description = 'From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, release management. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa\'s own toolchain, open-sourced.';
|
const description = 'From nothing to Submit for review on Google Play and the App Store: app records, listings in every language, in-app products with regional prices, every questionnaire (Data safety, IARC, target audience, ads, App Privacy, age rating, export compliance), privacy, icons, screenshots and previews, validate, TestFlight, release management, and after launch: crash vitals, review replies, price sheets, store analytics, Product Page Optimization. Agent Skills plus a Bun CLI and MCP server (storebound); you press Submit. CRTkafa\'s own toolchain, open-sourced.';
|
||||||
const keywords = ['google-play', 'app-store', 'app-store-connect', 'mobile-games', 'iap', 'screenshots', 'app-icons', 'release', 'aso', 'mcp'];
|
const keywords = ['google-play', 'app-store', 'app-store-connect', 'mobile-games', 'iap', 'screenshots', 'app-icons', 'release', 'aso', 'mcp'];
|
||||||
|
|
||||||
// 1. Claude Code plugin + its MCP server + marketplace
|
// 1. Claude Code plugin + its MCP server + marketplace
|
||||||
|
|
@ -72,7 +72,7 @@ export function generate(root: string): Map<string, string> {
|
||||||
'## Tools',
|
'## Tools',
|
||||||
'',
|
'',
|
||||||
'- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.',
|
'- CLI: `storebound <command>` (`storebound help`); config `storebound.config.ts`, credentials in env or `.storebound/`.',
|
||||||
'- MCP: `storebound mcp` (stdio). Write tools default to `dry_run: true`; submit / release / cancel / delete are not exposed.',
|
'- MCP: `storebound mcp` (stdio). MCP 2026-07-28 + 2025-11-25. Write tools default to `dry_run: true`; submit / release / cancel / delete / send are not exposed.',
|
||||||
'- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).',
|
'- Readiness: `storebound check` (offline), `storebound validate` (read-only, both stores).',
|
||||||
].join('\n');
|
].join('\n');
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue