Skip to content

Working with locally linked test‐scene

Jump to bottom
Pravus edited this page Aug 19, 2025 · 2 revisions

There are 2 ways to connect a local scene to your local version of js-sdk-toolchain packages.

That is useful to test sdk changes locally in a scene without having to push to a branch and wait for the PR test package.

Every time you make changes to any of the code of those packages, you have to run make build again for it to have effect on the connected local scene.

Option A: Manually linking the local packages into the local scene

  1. Enter every relevant package folder (@dcl/sdk, @dcl/sdk-commands, @dcl/js-runtime, @dcl/react-ecs, @dcl/ecs) and run npm link
  2. Go to your local scene and run npm link @dcl/sdk @dcl/react-ecs @dcl/sdk-commands @dcl/js-runtime @dcl/ecs @dcl/ecs-math @dcl/asset-packs

Option B: Initializing the sdk7-scene-template inside the cloned repo, with relative paths to the packages

After cloning the js-sdk-toolchain repo run:

make install
make build
make init-test-scene

That will clone sdk7-scene-template at the root of the local repo and will change the @dcl/sdk, @dcl/sdk-commands, @dcl/js-runtime paths to the relative local path of your locally cloned js-sdk-toolchain repo.

Clone this wiki locally