SUPOS 3DAsset Preview (Babylon.js)

This app is a Babylon.js-based 3D model viewer. It supports two entry modes:

1. modelUrl (fallback): load a model directly
2. configUrl (preferred): fetch BindingData JSON, load/scale/frame the model, then start MQTT realtime binding by default (toggleable in the status overlay)

Run (dev)

cd /home/fangye100/Documents/projects/BabylonJS/3DAssetPreview
npm install
npm run dev:https

configUrl flow (QR entry)

Open the viewer with:

https://127.0.0.1:5173/?configUrl=https://your-config-host/binding-data.json

Expected config structure: /home/fangye100/Documents/projects/BabylonJS/specs/003-3d-mqtt-binding/contracts/binding-data.schema.json

Notes:

• Realtime is WSS-only.
• URL query params are redacted in the UI/logs by default.

modelUrl flow (fallback)

https://127.0.0.1:5173/?modelUrl=https://example.com/model.glb

CORS workaround (dev only)

If configUrl or model.fileUrl is blocked by CORS, use the repo reverse proxy:

• Docs: /home/fangye100/Documents/projects/BabylonJS/reverse-proxy/README.md
• Quickstart: /home/fangye100/Documents/projects/BabylonJS/specs/003-3d-mqtt-binding/quickstart.md