The contribution docs say to run:
npm run serve -w @tools/sandbox
But on a fresh/current checkout, the sandbox can fail because the Vite config aliases dev packages to dist and the dist artifacts may not be generated. I hit missing shader imports such as core/dist/Shaders/lod3D.fragment.js.
After generating dist, the page can still fail because the sandbox entry does not import required side-effect modules for LoadingScreen and Inspector v2:
- LoadingScreen needs to be imported before…
- Cannot read properties of undefined (reading ‘show’) when opening Inspector
Locally, adding these to packages/tools/sandbox/src/main.ts fixes the runtime side-effect issues:
import “core/Loading/loadingScreen”;
import “inspector/legacy/legacy”;
And adding this alias to packages/tools/sandbox/vite.config.ts is required for the inspector import:
inspector: path.resolve(“../../dev/inspector-v2/dist”),
The docs may also need to mention running build:assets/build:source before serve, or the serve script should ensure required dist artifacts exist.
