This monorepo contains the core packages for Decentraland's SDK and development tools.
git clone https://github.com/decentraland/js-sdk-toolchain.git
cd js-sdk-toolchain
make install
make build
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
# Run all tests
make test
# Run ECS tests
make test-ecs
# Run Inspector tests
make test-inspector
# Run tests with coverage
make test-coverage
# Update test snapshots
make update-snapshots
The project uses Protocol Buffers for type-safe communication. Protobuf files are automatically compiled during the build process.
To manually rebuild protobuf files:
make proto
We use snapshot testing with golden files to track runtime performance impacts:
make build update-snapshots
to update golden filesmake deep-clean-and-snapshot
Note: This cleans all local changes in your git working tree
# All tests
make test
# Specific package
make test-ecs
make test-inspector
The main branch contains SDK7, the current version. All new features and improvements target SDK7.
SDK6 is maintained in the 6.x.x
branch for critical fixes:
6.x.x
branchdecentraland-ecs
packageIf you encounter build issues:
make clean && make install
make build && make test
Common issues:
make clean && make install && make build
make test
to see detailed errorsmake proto
to rebuild protocol buffersnode_modules
and run make install
againpackage.json
filesFor a deeper understanding of the architecture and design decisions:
For more ADRs, visit our ADR repository.
Apache 2.0