Threejs QA Release

Three.js QA Release

Prove the app or game works as its user encounters it and that the production build is shippable.

Read ../../references/verification-policy.md first. Do not start browser, Playwright, canvas, screenshot, diagnostics, release-preview, or mobile work without approval for that scope.

Read By Need

• Core QA, responsive behavior, performance, evidence, and release: references/qa-release-checklists.md.
• Screenshot baselines or visual regression: references/visual-test-harness.md.
• Game-only scripted play, difficulty, fairness, or softlocks: references/game-playtest-bot.md.

Default Minimum

Without additional approval, run only the policy's automatic minimum: the smallest build/typecheck gate, focused existing non-browser tests, and local asset/import-path checks. Fix owned failures, then state that extended browser QA was not run and offer a concrete desktop QA pass.

Approved Desktop QA Workflow

1. Confirm the approved scope, then start the intended dev or production preview.
2. Capture console, page, and relevant network errors.
3. Verify nonblank canvas pixels and the approved active desktop view.
4. Exercise the primary user journey and changed risky paths.
5. Test loading, empty, unsupported, and error states when applicable.
6. Check desktop UI fit, input cancellation, and resize.
7. If audio changed, verify gesture unlock, decode/load, triggers, loops, cleanup, mute, and volume.
8. Add deterministic screenshot baselines only when separately approved; otherwise record that they were not run.
9. Run canvas diagnostics, profiling, production-preview checks, or game bot playtests only when the user approved those checks.
10. Record commands, artifacts, issues, and remaining risks.

After desktop QA, offer mobile as a separate second step. Do not infer mobile approval from desktop approval.

Canvas Inspector

After canvas-inspector approval, run from the target project so its @playwright/test and pngjs dependencies are used:

node <this-skill-dir>/scripts/inspect-threejs-canvas.mjs --url http://127.0.0.1:5188

Add --mobile, --state <name>, and --seed <n> as needed. The JSON contains canvas metrics and renderer-budget comparisons. Blank/error conditions exit nonzero.

The game scaffold creator copies this canonical inspector into generated games, so they remain self-contained without duplicated source.

Approved Release Workflow

1. Inspect scripts, Vite base, public assets, and deployment assumptions.
2. Gate debug UI, verbose logging, and test helpers.
3. Run production build and preview.
4. Recheck desktop/mobile interaction and asset paths in built output.
5. Review bundle size, large assets, and third-party asset notices.
6. Report deployment commands and residual risks.

Final Response

Lead with pass/fail. Include commands, URL, primary journey or game loop, controls, screenshots/artifacts, issues, canvas/performance evidence, visual harness and game-bot decisions when relevant, deployment notes, and risks. Always disclose extended browser QA that was not run and whether mobile still requires approval.