Skip to content

Production checklist

Before shipping a Packaged build, run this list.

  • Strip dev URL. Replace http://localhost:5173 with your CDN/embedded URL. Either set per-widget URL to the production URL or set Default Dev URL to your production URL.
  • Build the React app. pnpm build produces dist/ — host on a CDN, or embed by copying into Content/ and pointing the URL at the file:// path (note CEF same-origin policies).
  • Disable UnrealDevPanel. Wrap in {import.meta.env.DEV && <UnrealDevPanel/>}.
  • Disable Debug Mode. Project Settings → Plugins → Unreal React Bridge → Debug Mode → false.
  • Verify MaxEventQueueSize. If you push state in BeginPlay, the default 100 is usually fine. Raise to 200–500 for heavy startup bursts.
  • Audit bForceBackgroundTransparent. Keep it on unless you've shipped opaque HUDs by design.
  • Test on target platform. Mac UE 5.7 has known transparency + keyboard-focus regressions — see Transparent HUD and Chat & keyboard focus.
  • Bind OnBridgeError in your HUD widget to capture runtime failures (e.g. forward to your telemetry).

Released under the MIT License.