fix: serve the demo on phaser.boringstack.xyz

.github/desired-repo-settings.json

@@ -6,7 +6,8 @@
     "dependabot_security_updates": "enabled"
   },
   "pages": {
-    "build_type": "workflow"
+    "build_type": "workflow",
+    "cname": "phaser.boringstack.xyz"
   },
   "actions": {
     "can_approve_pull_request_reviews": true

BUILD_THE_GAME.md

@@ -102,7 +102,7 @@ There are three GitHub settings the template can't flip for you, because the def
 
 | Setting | Path | Why |
 | --- | --- | --- |
-| **Pages** | Settings → Pages → Build and deployment → Source: **"GitHub Actions"** | The `deploy-pages` workflow 404s without this; the workflow can't enable Pages itself without a broader token. |
+| **Pages** | Settings → Pages → Build and deployment → Source: **"GitHub Actions"** | The `deploy-pages` workflow 404s without this; the workflow can't enable Pages itself without a broader token. The org demo uses the custom domain `phaser.boringstack.xyz` — do **not** copy that CNAME onto a fork. |
 | **Actions may open PRs** | Settings → Actions → General → Workflow permissions → **[x] Allow GitHub Actions to create and approve pull requests** | So `release-please` can cut release PRs from conventional commits. |
 | **Template repository** | Settings → General → **[x] Template repository** | So *your* forkers see the "Use this template" button. |
 
@@ -117,6 +117,17 @@ gh api -X PUT /repos/<owner>/<repo>/actions/permissions/workflow \
   -f default_workflow_permissions=write -F can_approve_pull_request_reviews=true
 ```
 
+The **org** demo is [phaser.boringstack.xyz](https://phaser.boringstack.xyz/). Chrome flags `boringstack-xyz.github.io` as a lookalike of `boringstack.xyz`, so the Pages site uses a real `boringstack.xyz` subdomain. Cloudflare DNS (DNS-only, not proxied):
+
+```
+Type   CNAME
+Name   phaser
+Target boringstack-xyz.github.io
+Proxy  DNS only
+```
+
+Then in the repo: Settings → Pages → Custom domain `phaser.boringstack.xyz` → Enforce HTTPS once the certificate exists.
+
 ### Step 4 — Understand the demo slice
 
 The forked repo ships with a tiny vertical slice:

README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <a href="https://boringstack.xyz"><img src="https://img.shields.io/badge/boringstack.xyz-4ade80?style=for-the-badge&logo=safari&logoColor=4ade80&labelColor=090909" alt="boringstack.xyz"></a>
   <a href="https://github.com/boringstack-xyz/Phaser-TypeScript-AI-First-Starter"><img src="https://img.shields.io/badge/GitHub-2563eb?style=for-the-badge&logo=github&logoColor=2563eb&labelColor=090909" alt="GitHub"></a>
-  <a href="https://boringstack-xyz.github.io/Phaser-TypeScript-AI-First-Starter/"><img src="https://img.shields.io/badge/Play_the_demo-2563eb?style=for-the-badge&logo=phaser&logoColor=2563eb&labelColor=090909" alt="Play the demo"></a>
+  <a href="https://phaser.boringstack.xyz/"><img src="https://img.shields.io/badge/Play_the_demo-2563eb?style=for-the-badge&logo=phaser&logoColor=2563eb&labelColor=090909" alt="Play the demo"></a>
 </p>
 
 <p align="center">
@@ -41,7 +41,7 @@ Backend engineer, tech lead, web developer who always wanted to make games? Star
 
 ### After forking: one-time repo setup
 
-1. **Enable GitHub Pages** — `Settings → Pages → Build and deployment → Source: "GitHub Actions"`. Without this the `deploy-pages` workflow 404s on the first run.
+1. **Enable GitHub Pages** — `Settings → Pages → Build and deployment → Source: "GitHub Actions"`. Without this the `deploy-pages` workflow 404s on the first run. The org demo is served at [phaser.boringstack.xyz](https://phaser.boringstack.xyz/) (Chrome treats `boringstack-xyz.github.io` as a lookalike of `boringstack.xyz`). Forks keep the default `https://<user>.github.io/<repo>/` URL.
 2. **Allow Actions to open PRs** (so release-please can cut release PRs) — `Settings → Actions → General → Workflow permissions → [x] Allow GitHub Actions to create and approve pull requests`.
 3. **Flip "Template repository"** — `Settings → General → Template repository` so your own "Use this template" button works.
 

docs/learn/05-solo-dev-workflow.md

@@ -105,7 +105,7 @@ For a 20-minute feature, skip the pipeline. For a 2-day feature, always run it.
 ### GitHub Pages (this template)
 - Free, one-click
 - Perfect for prototypes, devlogs, and portfolio pieces
-- URL format `https://<user>.github.io/<repo>/` is fine for sharing
+- URL format `https://<user>.github.io/<repo>/` is fine for sharing on a fork. The org demo is [phaser.boringstack.xyz](https://phaser.boringstack.xyz/) so Chrome does not treat `boringstack-xyz.github.io` as a lookalike of `boringstack.xyz`.
 
 ### Your own domain
 - Worth it once you have a name / brand