diff --git a/ui/frontend/src/api/synthetic-report.ts b/ui/frontend/src/api/synthetic-report.ts
index d4ea0e1..7d83657 100644
--- a/ui/frontend/src/api/synthetic-report.ts
+++ b/ui/frontend/src/api/synthetic-report.ts
@@ -1,6 +1,8 @@
 // DEV-only synthetic-report loader. Backs the "Load synthetic report"
-// affordance on the lobby (visible behind `import.meta.env.DEV`) and
-// the in-game shell layout's bypass for the synthetic game id range.
+// affordance on the lobby (visible when the build-time flag
+// `VITE_GALAXY_DEV_AFFORDANCES === "true"` — the dev and dev-deploy
+// bundles; stripped from prod) and the in-game shell layout's bypass
+// for the synthetic game id range.
 //
 // The accepted JSON shape mirrors `pkg/model/report.Report` as
 // emitted by `tools/local-dev/legacy-report/cmd/legacy-report-to-json`.