Develop

IWSDK Troubleshooting

Updated: Jul 22, 2026

Use the symptom that matches your problem, and then check the named setting or output. These checks cover common setup failures in IWSDK projects.

XR session entry

If the “Enter XR” button is missing, confirm that the app uses HTTPS. Check the configured sessionMode and browser support as well.

Hand tracking

If hand tracking is unavailable, enable it in the World.create() XR feature configuration.

import { SessionMode, World } from '@iwsdk/core';

const world = await World.create(document.getElementById('scene-container'), {
  xr: {
    sessionMode: SessionMode.ImmersiveVR,
    features: { handTracking: true },
  },
});

Generated assets

If a GLXF file is missing, confirm that generateGLXF writes the file under /public/glxf. For a UIKitML configuration 404, confirm that the compiled JSON exists under /public/ui.

Optimized assets

If an optimized asset appears more than once, use the plugin’s dependency blocking rather than adding another copy. This lets the optimizer manage the shared dependency.