@genex-ai/cli-demo 0.80.2-dev.213 → 0.81.0-dev.214

package/dist/index.js

@@ -3006,11 +3006,29 @@ async function walkFiles(dir) {
   return out;
 }
 async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
+  const viewportFindings = [];
+  try {
+    const indexHtml = await fs10.readFile(path10.join(cwd, "index.html"), "utf8");
+    if (!/<meta[^>]+name=["']viewport["']/i.test(indexHtml)) {
+      viewportFindings.push({
+        kind: "viewport-meta",
+        message: `index.html has no viewport meta \u2014 phones will render a zoomed-out desktop canvas. Add: <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">`
+      });
+    } else if (!/viewport-fit\s*=/i.test(indexHtml)) {
+      viewportFindings.push({
+        kind: "viewport-meta",
+        message: `index.html's viewport meta lacks viewport-fit=cover \u2014 env(safe-area-inset-*) (touch-kit widget offsets) is 0 without it. Append ", viewport-fit=cover" to the meta's content.`
+      });
+    }
+  } catch {
+  }
   const absAssets = path10.resolve(cwd, assetDir);
   try {
-    if (!(await fs10.stat(absAssets)).isDirectory()) return null;
+    if (!(await fs10.stat(absAssets)).isDirectory()) {
+      return viewportFindings.length > 0 ? viewportFindings : null;
+    }
   } catch {
-    return null;
+    return viewportFindings.length > 0 ? viewportFindings : null;
   }
   const srcFiles = (await walkFiles(path10.resolve(cwd, srcDir))).filter(
     (p) => AUDIT_SRC_EXTS.has(path10.extname(p).toLowerCase())
@@ -3030,7 +3048,7 @@ async function collectUiAuditFindings(assetDir, srcDir, cwd = process.cwd()) {
     }
   }
   const referenced = (basename) => sources.some((s) => s.text.includes(basename));
-  const findings = [];
+  const findings = [...viewportFindings];
   const assetFiles = await walkFiles(absAssets);
   const maskReported = /* @__PURE__ */ new Set();
   for (const p of assetFiles) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.80.2-dev.213",
+  "version": "0.81.0-dev.214",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-ai-hud/SKILL.md

@@ -615,7 +615,8 @@ after a bad single costs the whole chain).
   Use the returned hex verbatim for the DOM text over that region.
 - `npx genex ui trim --in <png>` — crop to alpha content + report real dims.
 - `npx genex ui audit [--dir public/assets/hud] [--src src]` — the mechanical
-  wiring scan (unreferenced sprites/masks, naive %-fill patterns); warn-only,
+  wiring scan (unreferenced sprites/masks, naive %-fill patterns, and a
+  missing/incomplete mobile viewport meta in the root `index.html`); warn-only,
   `--strict` exits 1 on findings.
 
 ## Troubleshooting

package/templates/skills/genex-threejs-touch-controls/SKILL.md

@@ -149,6 +149,13 @@ z-order stays: drag zone (5) under joystick/buttons (10) under pause menus.
 - **Safe-area insets are built in** — default positions clear notches and the
   home indicator. If you position widgets yourself near screen edges, keep
   `env(safe-area-inset-*)` in the calc.
+- **Viewport meta is a prerequisite** — every `env(safe-area-inset-*)` value is
+  silently **0** unless the page's viewport meta carries `viewport-fit=cover`.
+  Ship `<meta name="viewport" content="width=device-width, initial-scale=1,
+  viewport-fit=cover">` in the game's own `index.html`: the platform edge-injects
+  a default for published games, but the local dev server doesn't go through
+  that edge — without your own meta, widgets hug the notch in local testing
+  and look different from production.
 - **The drag zone swallows its touches** — taps inside it don't reach the
   canvas. If the game also needs taps there (tap to shoot), read them from the
   zone (`onChange` + a small-movement threshold) or shrink the zone.