Workspaces

Run multiple Decentraland projects in preview by grouping these into a workspace. Run multiple adjacent scenes to see how they fit, or also run multiple smart wearables together to see how they interact with each other and with different scenes.

Running multiple projects in a workspace provides a much more complete testing alternative, to ensure different content works well together. A workspace is a debugging feature, it doesn’t affect the experience in the published scene.

📔 Note: The Creator Hub doesn’t currently support handling Workspaces. Use the VS Studio Code extension instead.

Create a workspace #

1. Download the Goerli Plaza repo.

2. Create a separate top-level folder to hold the workspace.

3. From the Goerli Plaza repo, copy the following files over to your workspace:

   • dcl-workspace.json
   • package.json
   • .gitignore

4. Inside this folder, add one folder at root level for each project you want to work with. You can drag in existing folders with scenes or smart wearables. For new folders, run npx sdk-commands init inside each, to create a Decentraland project.

   Note: Make sure that the parcels on each of the scenes don’t overlap.

5. Standing on the workspace folder, run the following, to create the necessary files:

   npm run update-parcels && npm run sync && npm run test && npm run format

You can confirm that the projects are part of the workspace by running dcl workspace ls.

Run a workspace #

Run npm run start on the root folder of the workspace. This runs all of the projects at the same time, viewable in a single preview window. This preview behaves just like when previewing a single scene.

Any smart wearables in the workspace are available to try on by looking for them in the backpack.

Add projects #

Once a workspace is created, you can add additional projects dcl workspace add, including the relative address of the folder you want to add. For example dcl workspace add my-other-example.

You can also add a project that is not inside the workspace folder, by using the absolute path.

📔 Note: The folder must already contain a decentraland project initatied with npx sdk-commands init. It can’t be an empty folder.

You can also edit the dcl-workspace.json file manually to add or remove projects. Modify the file to include the relative paths to each of the projects in the workspace in the folders array.

{
	"folders": [
		{
			"path": "example-scene"
		},
		{
			"path": "example-scene2"
		}
	]
}