godot-platform-web

NEVER Do (Expert Web Rules)

Persistence & Storage

• NEVER use FileAccess alone for persistent web saves — Prefer web_local_storage_wrapper.gd (localStorage / IndexedDB via JavaScriptBridge).
• NEVER assume localStorage is permanent — Implement cloud-save fallback for production.

Rendering & Logic

• NEVER use the Forward+ renderer for web — Use Compatibility (WebGL 2.0).
• NEVER block the browser event loop — Long sync work → "Kill the Page." Use await / threaded workers where available.
• NEVER ignore COOP/COEP — Threads/SharedArrayBuffer need cross-origin isolation.

UX & Security

• NEVER forget tab focus loss — Pause audio on visibilitychange.
• NEVER trigger Fullscreen/Mouse Lock without a click — Must be inside a user gesture.
• NEVER use absolute paths in HTML shells — Relative paths for subdirectory hosting.

Host checklist (procedure)