Play · architecture profile

SHOALSHOT

Mobile-first fishing arcade with a shared radio. A static Phaser and React build on Cloudflare with no server-side game runtime.

LiveArchitecture reviewed 7 November 2026Dossier reviewed 19 October 2026

How it is built.

SHOALSHOT is delivered as static assets with a single-page fallback. It has no D1, R2 or KV binding and no Worker route of its own. The game reports anonymous engagement to Woodhouse and takes music from LoftwahFM, but neither dependency is required to open it.

Stack
Phaser 3.86, React 19.2, TypeScript, Vite 8, Tailwind 4Evidence: package.json
Runtime
Cloudflare static assets with SPA fallback; no Worker script in the reviewed configEvidence: wrangler.jsonc
Storage
No platform bindings. Saves and preferences are browser-local.Evidence: wrangler.jsonc
Identity
No accounts or sign-in.Evidence: package.json; wrangler.jsonc
Delivery
Cloudflare custom domain shoalshot.loftwah.com, preview URLs enabledEvidence: wrangler.jsonc routes
Integrations
LoftwahFM radio client 1.2.0 with the low-tide station; consent-gated anonymous engagement posted to WoodhouseEvidence: package.json; src/platform/radio.ts; src/platform/gameplay-analytics.ts

The shape of the system.

  1. ClientPhaser renders the dive; React owns routes, dialogs and settings.Evidence: src/app; src/scene
  2. AudioThe game adapter supplies the station and the host audio graph.Evidence: src/platform/radio.ts; src/platform/audio.ts
  3. EngagementAnonymous play events use the woodhouse.engagement/1 contract and are sent without credentials.Evidence: src/platform/gameplay-analytics.ts

Engineering decisions worth knowing.

  • Static delivery is the default for a solo game

    A game that needs no server data does not need a Worker. SPA fallback is the only routing behaviour the deployment adds.

  • Mobile first is a layout constraint, not a theme

    The game is designed for a phone viewport first; the desktop view expands the same play field rather than inventing a second interface.

What it connects to.

  • SHOALSHOTLoftwahFMradio client 1.2.0two-way

    SHOALSHOT pins the same client with the low-tide station. Its adapter supplies the game id and origin, and listening-v1 events go back to LoftwahFM so the telemetry distinguishes a real deployment from a test.

    Evidence: SHOALSHOT package.json; src/platform/radio.ts; LoftwahFM docs/radio-game-integration.md

  • SHOALSHOTWoodhouseengagement ingress

    SHOALSHOT posts the same woodhouse.engagement/1 contract for its dive mode only after consent. The report is fire-and-forget and carries no account.

    Evidence: SHOALSHOT src/platform/gameplay-analytics.ts; Woodhouse src/data/engagement.ts

Authoritative public sources

What this review does not know.

  • The engagement contract's server-side deduplication and retention were not re-verified in this review.
  • No physical-phone performance measurement was repeated for this profile.
  • No assistive-technology test was performed.