@dcl/sdk-commands

CLI tools for Decentraland scene development.

Overview

This package provides command-line tools for creating, developing, and deploying Decentraland scenes. It includes commands for:

• Initializing new scene projects
• Starting a local development server
• Building scenes
• Testing and validating scenes
• Managing scene deployments

Installation

npm install @dcl/sdk-commands

Usage

The SDK commands are used via npx to run the version installed in your project:

Create a New Scene

npx @dcl/sdk-commands init

Start Development Server

npx @dcl/sdk-commands start

Build Scene

npx @dcl/sdk-commands build

Deploy Scene

npx @dcl/sdk-commands deploy

Large scenes upload in batches when the target server supports it. While deploying, the linker server exposes the deployment at /api/deploy: GET returns its state (JSON, or server-sent events with Accept: text/event-stream) and DELETE cancels it. Cancelling needs the X-Deploy-Token header, set with --deploy-token <token> (16+ characters) or random per run; the browser gets it in the linker URL fragment (/#token=...).

Export Static Content

npx @dcl/sdk-commands export-static

Pack Smart Wearable

npx @dcl/sdk-commands pack-smart-wearable

Manage Quests

npx @dcl/sdk-commands quests

Development

Building the Package

# Build all packages in the monorepo
make build

Testing

# Run all tests in the monorepo
make test

# Run tests for a specific file
make test FILES="--watch packages/@dcl/sdk-commands/src/path/to/test.spec.ts"

Development Commands

For local development:

# Clean all build artifacts and reinstall dependencies
make clean && make install

# Format and fix linting issues
make lint-fix

# Update dependencies across packages
make sync-deps

Documentation

For detailed documentation on using the CLI tools, visit:

• CLI Documentation