Decentraland SDK Toolchain

August 21, 2025 · View on GitHub

This monorepo contains the core packages for Decentraland's SDK and development tools.

Packages

@dcl/sdk: Main SDK package for building Decentraland scenes using TypeScript/JavaScript
@dcl/ecs: Core Entity Component System (ECS) implementation with CRDT-based networking support
@dcl/react-ecs: React bindings for the ECS, providing a declarative way to build UIs using React's component model and JSX syntax
@dcl/js-runtime: TypeScript definitions for the Decentraland scene runtime environment.
@dcl/sdk-commands: CLI tools and commands for scene development, testing, and deployment
@dcl/playground-assets: Contains the built assets required by the Decentraland Playground

Quick Start

Clone the repository:

git clone https://github.com/decentraland/js-sdk-toolchain.git
cd js-sdk-toolchain

Install dependencies and build all packages:

make install
make build

Development

Building

The project uses a Makefile to handle all build tasks:

# Build everything (including protobuf)
make build

# Clean build artifacts
make clean

# Clean everything (including node_modules) and rebuild
make deep-clean && make install && make build

Testing

# Run all tests
make test

# Update test snapshots
make update-snapshots

Protobuf

The project uses Protocol Buffers for type-safe communication. Protobuf files are automatically compiled during the build process.

To manually rebuild protobuf files:

make build

Release Process

Merge changes to the main branch
Wait for CI workflow completion in GitHub Actions
Create a new Release following the version guidelines

Testing Infrastructure

Snapshot Testing

We use snapshot testing with golden files to track runtime performance impacts:

Snapshots measure QuickJS opcode execution for test scenes
Run make build update-snapshots to update golden files
For clean environment matching CI, use make deep-clean-and-snapshot

Note: This cleans all local changes in your git working tree