spatialpack pack

Synopsis

spatialpack pack <command> [options]

Description

Pack creation, build, and publish commands.

Build spatial packs from YAML pipeline definitions and publish to CDN.

Commands

Command	Description
pack build	Build a spatial pack from YAML pipeline.
pack info	Display information about a pipeline.
pack init	Initialize a new pack directory from template.
pack publish	Publish a built pack to S3 CDN.

Examples

# Initialize a new pack from template
spatialpack pack init ./my-pack --template solar-feasibility

# Build pack from pipeline YAML
spatialpack pack build pipeline.yaml -o ./output/

# Validate pipeline without executing
spatialpack pack build pipeline.yaml --dry-run

# Publish pack to S3 CDN
spatialpack pack publish ./packs/wa-feasibility-test --bucket spatial-dev-packs-cdn

Command Details

pack build

Build a spatial pack from YAML pipeline.

Executes the pipeline stages in dependency order, producing a complete spatial pack with manifest and integrity hashes.

spatialpack pack build PIPELINE_PATH [options]

Arguments

PIPELINE_PATH — path (required)

Options:

Option	Type	Default	Description
-o, --output	path	-	Output directory for the pack (default: ./output/)
--dry-run	flag	false	Validate pipeline without executing
--continue-on-error	flag	false	Continue execution after stage failures
--stage	text (multiple)	-	Run only specific stage(s)
--base-dir	directory	-	Base directory for resolving relative source paths. Defaults to current working directory.

# Build pack
spatialpack pack build pipeline.yaml -o ./wa-solar-pack/

# Dry run (validate only)
spatialpack pack build pipeline.yaml --dry-run

# Continue on errors
spatialpack pack build pipeline.yaml --continue-on-error

# Run specific stage(s)
spatialpack pack build pipeline.yaml --stage mosaic_dem --stage clip_dem

pack info

Display information about a pipeline.

Shows pipeline metadata, sources, stages, and execution plan without running the pipeline.

spatialpack pack info PIPELINE_PATH

Arguments

PIPELINE_PATH — path (required)

spatialpack pack info pipeline.yaml

pack init

Initialize a new pack directory from template.

Creates the pack folder structure with skeleton manifest and optional pipeline template.

spatialpack pack init PACK_PATH [options]

Arguments

PACK_PATH — path (required)

Options:

Option	Type	Default	Description
--template	basic | solar-feasibility | urban-planning	basic	Pack template to use (default: basic)
--pack-id	text	-	Pack identifier (e.g., spatial.properties:wa:solar-feasibility:v1)
--title	text	-	Human-readable pack title
--description	text	-	Pack description
--force	flag	false	Overwrite existing pack directory

# Create basic pack
spatialpack pack init ./my-pack

# Create solar feasibility pack
spatialpack pack init ./wa-solar --template solar-feasibility

# Create with custom metadata
spatialpack pack init ./my-pack --pack-id "org:region:theme:v1" --title "My Pack"

pack publish

Publish a built pack to S3 CDN.

Uploads all pack files with correct Content-Type and Cache-Control headers, rewrites manifest URIs to CDN URLs, and verifies integrity before upload.

spatialpack pack publish PACK_DIR [options]

Arguments

PACK_DIR — directory (required)

Options:

Option	Type	Default	Description
--bucket	text	-	S3 bucket name
--prefix	text	packs	S3 key prefix (default: packs)
--cdn-domain	text	cdn.spatial.properties	CDN domain for manifest URI rewriting
--profile	text	-	AWS profile name
--region	text	ap-southeast-2	AWS region
--dry-run	flag	false	Show what would be uploaded without uploading
--skip-integrity	flag	false	Skip pre-upload integrity verification

# Publish to S3
spatialpack pack publish ./packs/wa-feasibility-test --bucket spatial-dev-packs-cdn

# Dry run (see what would be uploaded)
spatialpack pack publish ./packs/wa-feasibility-test --bucket spatial-dev-packs-cdn --dry-run

# Custom CDN domain and AWS profile
spatialpack pack publish ./my-pack --bucket my-bucket --cdn-domain cdn.example.com --profile my-profile