Skip to content

Deploy

Build

bash
npm run build

Generates static files in dist/.

Server requirements

  • HTTPS required — WebXR and camera access require it
  • WASM MIME type — The server must serve .wasm as application/wasm
  • CORS — If loading assets from another domain, configure CORS

nginx configuration

nginx
server {
    listen 443 ssl;
    server_name your-domain.com;

    root /var/www/your-experience/dist;
    index index.html;

    # MIME type for WASM
    types {
        application/wasm wasm;
    }

    # SPA fallback
    location / {
        try_files $uri $uri/ /index.html;
    }
}

License in production

Remember that the license key is associated with a domain. Make sure the production domain is authorized in your license.

Validation only occurs during tracker.init(), so the SDK needs an internet connection at that moment.

Deploy checklist

  • [ ] Build completes without errors
  • [ ] HTTPS configured
  • [ ] .wasm MIME type configured
  • [ ] Domain authorized in the license
  • [ ] Assets (models, textures, markers) accessible
  • [ ] Tested on a real device (not just desktop)