Production checklist
Before shipping a Packaged build, run this list.
- ✅ Strip dev URL. Replace
http://localhost:5173with your CDN/embedded URL. Either set per-widgetURLto the production URL or setDefault Dev URLto your production URL. - ✅ Build the React app.
pnpm buildproducesdist/— host on a CDN, or embed by copying intoContent/and pointing the URL at thefile://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 inBeginPlay, 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
OnBridgeErrorin your HUD widget to capture runtime failures (e.g. forward to your telemetry).