@mpgd/cli 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -49,18 +49,18 @@
     "@types/node": "^24.0.0",
     "ttsc": "0.16.9",
     "typescript": "7.0.1-rc",
-    "@mpgd/adapter-browser": "0.4.0",
-    "@mpgd/adapter-devvit": "0.4.0",
-    "@mpgd/adapter-capacitor": "0.4.0",
-    "@mpgd/analytics": "0.3.3",
-    "@mpgd/adapter-ait": "0.4.0",
+    "@mpgd/adapter-ait": "0.4.1",
+    "@mpgd/adapter-devvit": "0.5.0",
+    "@mpgd/analytics": "0.3.4",
+    "@mpgd/adapter-browser": "0.4.1",
+    "@mpgd/adapter-capacitor": "0.4.1",
     "@mpgd/bridge": "0.5.0",
-    "@mpgd/catalog": "0.3.3",
-    "@mpgd/i18n": "0.4.1",
-    "@mpgd/game-services": "0.4.0",
+    "@mpgd/catalog": "0.3.4",
+    "@mpgd/game-services": "0.5.0",
+    "@mpgd/i18n": "0.5.0",
+    "@mpgd/platform": "0.5.0",
     "@mpgd/phaser-assets": "0.4.0",
-    "@mpgd/platform": "0.4.0",
-    "@mpgd/target-config": "0.5.0"
+    "@mpgd/target-config": "0.6.0"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/phaser-game/README.md

@@ -32,6 +32,7 @@ pnpm exec mpgd target build-all \
   --targets-file ./mpgd.targets.json \
   --kit-path ../mpgd-kit \
   --targets web,microsoft-store,ait,reddit \
+  --profile staging \
   --ait-variant wrapper
 pnpm exec mpgd target smoke-all \
   --targets-file ./mpgd.targets.json \
@@ -51,6 +52,7 @@ pnpm --dir ../mpgd-kit mpgd target build-all \
   --targets-file "$PWD/mpgd.targets.json" \
   --kit-path ../mpgd-kit \
   --targets web,microsoft-store,ait,reddit \
+  --profile staging \
   --ait-variant wrapper
 ```
 
@@ -58,10 +60,37 @@ pnpm --dir ../mpgd-kit mpgd target build-all \
 into `.mpgd.targets.generated.json` before calling the kit's existing target
 build and smoke scripts.
 
+The starter's Apps in Toss and Capacitor entries intentionally point at kit
+reference wrappers, so their reusable validation builds use the `staging`
+profile. Before an AIT, Android, or iOS production build, copy or create the
+wrapper/shell under this game directory, update `mpgd.targets.json`, and set
+`VITE_MPGD_GAME_SERVICES_URL` to a public HTTPS endpoint without embedded
+credentials. Production preflight resolves real paths, rejects wrappers or
+shells outside the game root (including symbolic-link escapes), and blocks
+localhost plus literal private or reserved IP addresses.
+
 `mpgd target doctor` verifies that release manifest artifact paths stay under
 this game directory, even when a build used the kit reference Apps in Toss or
 Capacitor wrappers.
 
+## Acceptance Handoff
+
+Run the reusable acceptance workflow before handing the game off:
+
+```sh
+pnpm accept
+```
+
+The command runs `check`, an optional `test` script, `build`, the kit's ttsc
+graph preflight, an optional game-owned `playtest` script, and the configured
+target build/smoke matrix. Results are written as JSON and Markdown under
+`artifacts/acceptance`. Add a non-interactive `playtest` package script when the
+game has an automated browser scenario; interactive platform playtests remain
+separate operator workflows.
+Each command has a 30-minute timeout by default. Pass `--timeout-ms` to the
+underlying `mpgd game accept` command when a target matrix needs a different
+per-step limit.
+
 ## Assets
 
 Static assets live under `src/assets` and are declared in
@@ -116,6 +145,24 @@ soft rotate prompt on mismatch. The generated PWA manifest also declares
 that manifest value aligned with the runtime policy if you make a portrait-first
 game.
 
+## App Icons
+
+`mpgd.game.json` owns one canonical PNG or SVG app icon source. Target profiles
+derive each platform's required sizes, safe zones, alpha policy, and native or
+wrapper staging files.
+
+```sh
+pnpm icons:generate
+pnpm icons:verify
+pnpm icons:inspect
+```
+
+Use each target's optional `icon` object in `mpgd.targets.json` for a profile,
+background, source, or variant override. The release evidence still records the
+shared canonical source separately from an override render source. Before an
+Apps in Toss production package build, upload the generated 600x600 icon in the
+console and configure the returned HTTPS URL as `ait.icon.externalUrl`.
+
 ## Reddit Devvit
 
 This starter owns its Devvit app root in `apps/target-devvit`. That directory
@@ -126,10 +173,17 @@ The generated `devvit.json` app name is a Devvit-safe slug derived from the game
 directory name; edit it before `devvit:init` if you need a different Reddit app
 name.
 
+The default post entry builds a lightweight inline preview without importing
+Phaser. Its Play button requests the separate `game` entrypoint, whose
+`game.html` document starts the Phaser bundle directly. Keep these physical
+entries separate when customizing the preview so Reddit cards do not pay the
+game runtime cost before expansion.
+
 First-time Devvit setup:
 
 ```sh
 pnpm install -w
+pnpm icons:generate:devvit:production
 pnpm devvit:login
 pnpm devvit:whoami
 pnpm devvit:init
@@ -218,7 +272,14 @@ submission.
 - Microsoft Store is a game-owned PWA target that reuses the browser adapter and
   writes to `artifacts/microsoft-store` with `manifest.webmanifest` for
   PWABuilder packaging. Replace the starter icon and manifest metadata before
-  Store submission.
+  Store submission. Production builds also emit `pwa-release.json` and an
+  atomic offline `service-worker.js`; its deterministic revision covers every
+  precached artifact plus the game and kit Git provenance. Updates intentionally
+  wait while any old app window remains open. Listen for
+  `mpgd:pwa-update-ready` to tell players to close every window and reopen the
+  app; do not force activation with `skipWaiting()`. Keep the web manifest `id`
+  game-specific because the cache namespace uses it to isolate apps sharing an
+  origin.
 - Reddit Devvit is game-owned in `apps/target-devvit`.
 - Apps in Toss currently uses the kit reference wrapper at
   `${MPGD_KIT_PATH}/apps/target-ait` for smoke packaging. Before a real Toss
@@ -242,3 +303,12 @@ VITE_MPGD_GAME_SERVICES_TRANSPORT=http
 
 Use `VITE_MPGD_GAME_SERVICES_TRANSPORT=orpc` with a `/rpc` URL to test the oRPC
 client path.
+
+The generated starter uses `createGameServicesRuntime` for backend selection
+and treats only the exact Vite `production` profile as production authority.
+Production fails closed when the URL is absent or is not public HTTPS without
+credentials: Game Services reports `missing_authoritative_backend` or
+`invalid_authoritative_backend` and does not create a client. Process-local
+backends require both a non-production authority mode and an explicit
+`allowLocalBackend` opt-in, so they cannot manufacture successful production
+purchase, rewarded-ad, or leaderboard ledger results.

package/templates/phaser-game/agent/acceptance.md

@@ -3,22 +3,28 @@
 Run these checks before handing off a generated game starter:
 
 ```sh
-pnpm check
-pnpm build
-pnpm --dir ../mpgd-kit mpgd target build-all --targets-file "$PWD/mpgd.targets.json" --targets web,microsoft-store,ait,reddit --ait-variant wrapper
-pnpm --dir ../mpgd-kit mpgd target smoke-all --targets-file "$PWD/mpgd.targets.json" --targets web,microsoft-store,ait,reddit
-pnpm --dir ../mpgd-kit mpgd target doctor --targets-file "$PWD/mpgd.targets.json" --targets web,microsoft-store,ait,reddit
+pnpm icons:generate
+pnpm icons:verify
+pnpm accept
 ```
 
+`pnpm accept` runs the configured game check, optional test and playtest scripts,
+game build, kit TypeScript graph preflight, and the reusable target build/smoke
+matrix. It writes `artifacts/acceptance/acceptance-report.json` and
+`acceptance-report.md` for handoff. Missing optional `test` or `playtest` scripts
+are recorded as skipped; check and build remain required.
+
 For Apps in Toss changes, use the apps-in-toss MCP before implementation and
 keep SDK calls inside adapters or target wrappers.
 Resolve identity and launch intents during bootstrap, treat inbound share data as
 untrusted, and keep notification delivery on the server.
 
-For Reddit Devvit changes, keep Devvit SDK calls inside the target wrapper and
+For Reddit Devvit changes, keep Devvit SDK calls inside the adapter or target wrapper and
 continue to expose game-facing behavior through `PlatformGateway`. The Devvit
 app root is game-owned in `apps/target-devvit`; run `pnpm devvit:init` once
 after login before upload or playtest.
+Verify the default post entry renders only the lightweight inline preview and
+the `game` entry opens the separate expanded Phaser document.
 
 For Microsoft Store changes, keep the first pass as a PWA/web target that uses
 the browser adapter. Add a dedicated Store commerce adapter only when wiring

package/templates/phaser-game/agent/brief.md

@@ -18,7 +18,9 @@ Useful commands:
 pnpm dev
 pnpm check
 pnpm build
-pnpm exec mpgd target build-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets web,microsoft-store,ait,reddit --ait-variant wrapper
+pnpm icons:generate
+pnpm icons:verify
+pnpm exec mpgd target build-all --targets-file ./mpgd.targets.json --kit-path ../mpgd-kit --targets web,microsoft-store,ait,reddit --profile staging --ait-variant wrapper
 pnpm devvit:login
 pnpm devvit:init
 pnpm devvit:playtest

package/templates/phaser-game/agent/game-manifest.json

@@ -37,6 +37,10 @@
       "id": "platform.devvit.app-root",
       "owner": "apps/target-devvit"
     },
+    {
+      "id": "platform.devvit.surface-split",
+      "owner": "src/platform/devvitEntrypoint.ts"
+    },
     {
       "id": "services.backend.game-services",
       "owner": "src/platform/gameServices.ts"
@@ -51,6 +55,9 @@
     }
   ],
   "acceptance": [
+    "pnpm accept",
+    "pnpm icons:generate",
+    "pnpm icons:verify",
     "pnpm check",
     "pnpm build"
   ]

package/templates/phaser-game/apps/target-devvit/README.md

@@ -29,3 +29,33 @@ The client bundle is copied into `dist/client` by the mpgd target build. The ser
 compiled to `dist/server/index.cjs` and keeps Devvit SDK imports out of Phaser scenes.
 The game root pins `@mpgd/cli`, so these commands use the same CLI version as the generated
 starter's other `@mpgd/*` dependencies.
+
+The default post entry uses `index.html` for a lightweight inline preview. Its
+Play button requests the `game` entrypoint, which loads the separate
+`game.html` Phaser document. Keep inline UI free of game runtime imports so the
+card remains lightweight before expansion.
+
+## Durable Post Operations
+
+Use `src/server/postOperationStore.ts` with `@mpgd/adapter-devvit/server` for a
+server action or scheduler that may receive the same custom-post operation more
+than once. Use `{ appScope, subredditId }` as the scope, a stable `operationType`
+in the definition, and an `operationId` for each logical publication slot. Validate
+the public payload and launch parameters, then inject the Redis-backed store into
+`createDevvitPostOperationCoordinator`.
+
+The contract is duplicate-safe and ambiguity-safe, not exactly-once. It persists
+the attempt before invoking Reddit. If Reddit accepts the post but its response is
+lost, or the process stops before the receipt is saved, repeating `execute` returns
+`reconciliation-required` and never blindly calls the submit function again. An
+explicit recovery endpoint or scheduler calls `reconcile`, which requires an exact
+match of the full canonical envelope. A missing match from a bounded listing
+remains unresolved rather than restoring submit permission.
+
+Keep operation definitions and `@devvit/web/server` imports inside this target
+app. The canonical `{ mpgd, launch, payload }` envelope is public and untrusted;
+keep private content and authoritative records in server-side storage. Exercise
+first success, duplicate calls, interruption,
+response loss, lease expiry with concurrent reconciliation, malformed durable
+state, invalid launch metadata, and cross-scope key isolation before enabling a
+scheduled or user-triggered publication flow.

package/templates/phaser-game/apps/target-devvit/devvit.json

@@ -1,12 +1,19 @@
 {
   "$schema": "https://developers.reddit.com/schema/config-file.v1.json",
   "name": "__DEVVIT_APP_NAME__",
+  "marketingAssets": {
+    "icon": "generated/marketing-icon.png"
+  },
   "post": {
     "dir": "dist/client",
     "entrypoints": {
       "default": {
         "entry": "index.html",
         "height": "tall"
+      },
+      "game": {
+        "entry": "game.html",
+        "height": "tall"
       }
     }
   },

package/templates/phaser-game/apps/target-devvit/package.json

@@ -4,9 +4,11 @@
   "version": "0.0.0",
   "type": "module",
   "scripts": {
-    "init": "devvit upload --config devvit.json",
-    "init:copy-paste": "devvit upload --copy-paste --config devvit.json",
-    "dev": "devvit playtest --config devvit.json",
+    "prepare:icon": "pnpm --dir ../.. icons:generate:devvit",
+    "prepare:icon:production": "pnpm --dir ../.. icons:generate:devvit:production",
+    "init": "pnpm run prepare:icon:production && devvit upload --config devvit.json",
+    "init:copy-paste": "pnpm run prepare:icon:production && devvit upload --copy-paste --config devvit.json",
+    "dev": "pnpm run prepare:icon && devvit playtest --config devvit.json",
     "dev:prepare": "pnpm --dir ../.. build:devvit:staging",
     "dev:client": "APP_TARGET=reddit APP_VERSION=0.0.0-dev BUILD_ID=devvit-watch pnpm --dir ../.. exec vite build --mode staging --watch --outDir apps/target-devvit/dist/client",
     "dev:server": "vite build --config vite.server.config.ts --watch",
@@ -14,8 +16,8 @@
     "build": "pnpm --dir ../.. build:devvit",
     "build:server": "vite build --config vite.server.config.ts",
     "whoami": "devvit whoami",
-    "upload": "devvit upload --config devvit.json",
-    "publish": "devvit publish --config devvit.json",
+    "upload": "pnpm run prepare:icon:production && devvit upload --config devvit.json",
+    "publish": "pnpm run prepare:icon:production && devvit publish --config devvit.json",
     "check": "ttsc --noEmit -p tsconfig.json",
     "lint": "ttsc --noEmit -p tsconfig.json",
     "format": "ttsc format",
@@ -23,6 +25,7 @@
   },
   "dependencies": {
     "@devvit/web": "0.13.6",
+    "@mpgd/adapter-devvit": "__MPGD_DEPENDENCY_VERSION_ADAPTER_DEVVIT__",
     "@mpgd/bridge": "__MPGD_DEPENDENCY_VERSION_BRIDGE__",
     "express": "^5.2.1",
     "helmet": "^8.1.0"

package/templates/phaser-game/apps/target-devvit/src/server/postOperationStore.ts

@@ -0,0 +1,9 @@
+import { redis } from '@devvit/web/server';
+import {
+  createDevvitRedisPostOperationStore,
+  type DevvitDurableOperationStore,
+} from '@mpgd/adapter-devvit/server';
+
+export function createPostOperationStore(): DevvitDurableOperationStore {
+  return createDevvitRedisPostOperationStore(redis);
+}

package/templates/phaser-game/game.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#0f172a" />
+    <title>__GAME_TITLE__</title>
+  </head>
+  <body>
+    <div id="game"></div>
+    <script type="module" src="/src/gameEntry.ts"></script>
+  </body>
+</html>

package/templates/phaser-game/gitignore

@@ -1,9 +1,11 @@
 node_modules/
 dist/
 apps/*/dist/
+apps/target-devvit/generated/
 artifacts/
 release-output/
 .mpgd.targets.generated.json
+.mpgd/
 .env
 .env.*
 apps/*/.env

package/templates/phaser-game/index.html

@@ -4,11 +4,11 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#0f172a" />
-    <link rel="manifest" href="/manifest.webmanifest" />
+    <link rel="manifest" href="./manifest.webmanifest" />
     <title>__GAME_TITLE__</title>
   </head>
   <body>
     <div id="game"></div>
-    <script type="module" src="/src/main.ts"></script>
+    <script type="module" src="/src/entry.ts"></script>
   </body>
 </html>

package/templates/phaser-game/mpgd.game.json

@@ -0,0 +1,8 @@
+{
+  "brand": {
+    "appIcon": {
+      "source": "public/icon.svg",
+      "backgroundColor": "#0f172a"
+    }
+  }
+}

package/templates/phaser-game/mpgd.targets.json

@@ -4,12 +4,14 @@
       "kind": "web",
       "gameApp": ".",
       "adapter": "browser",
+      "icon": { "profile": "web-preview" },
       "output": "artifacts/web-preview"
     },
     "microsoft-store": {
       "kind": "web",
       "gameApp": ".",
       "adapter": "browser",
+      "icon": { "profile": "microsoft-pwa" },
       "output": "artifacts/microsoft-store"
     },
     "android": {
@@ -17,6 +19,7 @@
       "gameApp": ".",
       "shellApp": "${MPGD_KIT_PATH}/apps/mobile-capacitor",
       "adapter": "capacitor",
+      "icon": { "profile": "android" },
       "webDir": "${MPGD_KIT_PATH}/apps/mobile-capacitor/www",
       "artifact": "aab"
     },
@@ -25,6 +28,7 @@
       "gameApp": ".",
       "shellApp": "${MPGD_KIT_PATH}/apps/mobile-capacitor",
       "adapter": "capacitor",
+      "icon": { "profile": "ios" },
       "webDir": "${MPGD_KIT_PATH}/apps/mobile-capacitor/www",
       "artifact": "ipa"
     },
@@ -33,6 +37,7 @@
       "gameApp": ".",
       "wrapperApp": "${MPGD_KIT_PATH}/apps/target-ait",
       "adapter": "ait",
+      "icon": { "profile": "ait" },
       "webDir": "${MPGD_KIT_PATH}/apps/target-ait/public/game",
       "artifact": ".ait"
     },
@@ -41,6 +46,7 @@
       "gameApp": ".",
       "wrapperApp": "apps/target-devvit",
       "adapter": "devvit",
+      "icon": { "profile": "devvit" },
       "webDir": "apps/target-devvit/dist/client",
       "artifact": "devvit"
     }

package/templates/phaser-game/package.json

@@ -8,7 +8,13 @@
     "dev": "__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0",
     "dev:ait": "APP_TARGET=ait APP_VERSION=0.0.0-dev BUILD_ID=ait-sandbox sh -c '__WORKSPACE_I18N_BUILD_PREFIX__vite --host 0.0.0.0'",
     "build": "__WORKSPACE_I18N_BUILD_PREFIX__vite build",
-    "build:ait": "pnpm exec mpgd target build ait production --variant wrapper --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "accept": "node ./tools/run-game-acceptance.mjs",
+    "icons:generate": "pnpm exec mpgd game icons generate . --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "icons:generate:devvit": "pnpm exec mpgd game icons generate . --targets reddit --profile development --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "icons:generate:devvit:production": "pnpm exec mpgd game icons generate . --targets reddit --profile production --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "icons:verify": "pnpm exec mpgd game icons verify . --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "icons:inspect": "pnpm exec mpgd game icons inspect . --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
+    "build:ait": "pnpm exec mpgd target build ait staging --variant wrapper --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "build:ait:package": "pnpm exec mpgd target build ait production --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "smoke:ait": "pnpm exec mpgd target smoke ait --targets-file ./mpgd.targets.json --kit-path ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}",
     "ait:wrapper:dev": "pnpm --dir ${MPGD_KIT_PATH:-__DEFAULT_KIT_PATH__}/apps/target-ait run dev",

package/templates/phaser-game/public/manifest.webmanifest

@@ -3,6 +3,7 @@
   "name": "__GAME_TITLE__",
   "short_name": "__GAME_NAME__",
   "description": "__GAME_TITLE__ built with mpgd-kit.",
+  "id": "./__GAME_NAME__",
   "start_url": "./",
   "scope": "./",
   "display": "standalone",

package/templates/phaser-game/src/entry.ts

@@ -0,0 +1,7 @@
+if (__APP_TARGET__ === 'reddit') {
+  await import('./platform/devvitEntrypoint');
+} else {
+  await import('./main');
+}
+
+export {};

package/templates/phaser-game/src/env.d.ts

@@ -2,6 +2,9 @@
 
 declare const __APP_TARGET__: string;
 declare const __MPGD_CONFIG_TARGET__: string;
+declare const __MPGD_PLATFORM_TARGET__:
+  | import('@mpgd/target-config').EffectivePlatformTargetMetadata
+  | undefined;
 declare const __APP_VERSION__: string;
 declare const __BUILD_ID__: string;
 declare const __SOURCE_GIT_SHA__: string;

package/templates/phaser-game/src/gameEntry.ts

@@ -0,0 +1,3 @@
+await import('./main');
+
+export {};

package/templates/phaser-game/src/main.ts

@@ -1,7 +1,7 @@
 import './styles.css';
 
 import { createAnalyticsReporter, createBufferedAnalyticsSink } from '@mpgd/analytics';
-import { resolveMpgdLocale, type Locale } from '@mpgd/i18n';
+import { resolveTargetMpgdLocale, type Locale } from '@mpgd/i18n';
 import type { IdentitySession, LaunchIntent, PlatformGateway } from '@mpgd/platform';
 import {
   resolveTargetViewportPlan,
@@ -14,11 +14,13 @@ import { createStarterGame } from './runtime/createGame';
 import { detectRuntime } from './platform/runtimeDetector';
 import { createStarterGameServices } from './platform/gameServices';
 import { installPlatform } from './platform/installPlatform';
+import { installMicrosoftStorePwa } from './platform/microsoftStorePwa';
 
 await bootstrap();
 
 async function bootstrap(): Promise<void> {
   let locale: Locale = 'en';
+  let disposeMicrosoftStorePwa: (() => void) | undefined;
 
   try {
     if (__APP_TARGET__ === 'ait') {
@@ -27,6 +29,7 @@ async function bootstrap(): Promise<void> {
     }
 
     const runtimeConfig = detectRuntime();
+    disposeMicrosoftStorePwa = installMicrosoftStorePwa(runtimeConfig);
     const platform = await installPlatform(runtimeConfig);
     const runtime = await platform.getTargetRuntime();
     const orientationPolicy = {
@@ -46,7 +49,12 @@ async function bootstrap(): Promise<void> {
       resolveIdentitySession(platform, player.playerId),
       resolveLaunchIntent(platform),
     ]);
-    locale = resolveMpgdLocale(runtime.capabilities);
+    locale = resolveTargetMpgdLocale({
+      capabilities: runtime.capabilities,
+      fallbackLocale:
+        runtime.effectiveConfig?.localization.fallbackLocale
+        ?? runtime.config.localization.fallbackLocale,
+    });
     const analyticsSink = createBufferedAnalyticsSink();
     const analytics = createAnalyticsReporter({
       target: platform.target,
@@ -82,6 +90,7 @@ async function bootstrap(): Promise<void> {
       },
     });
   } catch (error) {
+    disposeMicrosoftStorePwa?.();
     renderBootstrapError(error, locale);
     console.error('[bootstrap]', error);
   }

package/templates/phaser-game/src/platform/buildGatewayModule.ts

@@ -0,0 +1,5 @@
+declare module '#mpgd-platform-gateway' {
+  export function createBuildGateway(
+    runtime: import('./runtimeDetector').RuntimeConfig,
+  ): Promise<import('@mpgd/platform').PlatformGateway>;
+}

package/templates/phaser-game/src/platform/buildGateways/ait.ts

@@ -0,0 +1,11 @@
+import { createAitPlatformGateway } from '@mpgd/adapter-ait';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createAitPlatformGateway({
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+  });
+}

package/templates/phaser-game/src/platform/buildGateways/aitSandbox.ts

@@ -0,0 +1,12 @@
+import { createAitPlatformGateway, createAitSandboxBridge } from '@mpgd/adapter-ait';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createAitPlatformGateway({
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+    fallbackBridge: createAitSandboxBridge(),
+  });
+}

package/templates/phaser-game/src/platform/buildGateways/browser.ts

@@ -0,0 +1,8 @@
+import { createBrowserPlatformGateway } from '@mpgd/adapter-browser';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(_runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createBrowserPlatformGateway();
+}

package/templates/phaser-game/src/platform/buildGateways/capacitorAndroid.ts

@@ -0,0 +1,12 @@
+import { createCapacitorPlatformGateway } from '@mpgd/adapter-capacitor';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createCapacitorPlatformGateway({
+    target: 'android',
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+  });
+}

package/templates/phaser-game/src/platform/buildGateways/capacitorIos.ts

@@ -0,0 +1,12 @@
+import { createCapacitorPlatformGateway } from '@mpgd/adapter-capacitor';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createCapacitorPlatformGateway({
+    target: 'ios',
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+  });
+}

package/templates/phaser-game/src/platform/buildGateways/reddit.ts

@@ -0,0 +1,11 @@
+import { createDevvitPlatformGateway } from '@mpgd/adapter-devvit';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createDevvitPlatformGateway({
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+  });
+}

package/templates/phaser-game/src/platform/buildGateways/redditSandbox.ts

@@ -0,0 +1,15 @@
+import {
+  createDevvitPlatformGateway,
+  createDevvitSandboxBridge,
+} from '@mpgd/adapter-devvit';
+import type { PlatformGateway } from '@mpgd/platform';
+
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  return createDevvitPlatformGateway({
+    appVersion: runtime.appVersion,
+    buildId: runtime.buildId,
+    fallbackBridge: createDevvitSandboxBridge(),
+  });
+}