Overview
The dex catalog command manages the entry catalog manifest, spotlight features, and publishes catalog curation to test and production environments.
Usage
dex catalog <manifest|stage|spotlight|validate|diff|publish|pull|seasons> [args]
Subcommands
Manifest Operations
Manage the catalog manifest entries.
list
add
edit
retire
remove
List catalog manifest entries.dex catalog manifest list
dex catalog manifest list --all
Show full manifest (staged + built) instead of just staged entries
Add a new entry to the catalog manifest.dex catalog manifest add --entry <slug|href|id> --lookup <lookup> --season <S#> --instrument <...> --performer <...>
Entry slug, href, or ID to add to catalog
Lookup number for the entry
Season identifier (e.g., S1, S2, S3)
Entry status: draft, active, or archived
Edit an existing catalog manifest entry.dex catalog manifest edit --entry <slug|href|id> [--lookup ... --season ... --instrument ... --performer ... --status ...]
Entry slug, href, or ID to edit
Update status: draft, active, or archived
Retire an entry (set status to archived).dex catalog manifest retire --entry <slug|href|id>
Entry slug, href, or ID to retire
Remove an entry from the catalog manifest.dex catalog manifest remove --entry <slug|href|id> [--force-remove]
Entry slug, href, or ID to remove
Force removal even if entry page exists (bypasses safety check)
Use --force-remove only with explicit approval. Prefer retire for linked entries.
Stage
Stage an entry from catalog.entries.json to the catalog manifest.
dex catalog stage --entry <slug|href|id> [--lookup ...]
Entry slug, href, or ID to stage
Spotlight
Set the catalog spotlight feature.
dex catalog spotlight set --entry <slug|href|id> [--headline ... --cta-label ...]
Entry slug, href, or ID for spotlight
Spotlight headline text (default: “ARTIST SPOTLIGHT”)
Call-to-action button label (default: “VIEW COLLECTION”)
Validate
Validate the catalog manifest and write snapshot.
Validation checks:
- Manifest schema compliance
- Spotlight entry exists in manifest
- Cross-references with home featured entries
- Entry page linkage
Diff
Compare local catalog with remote environment.
dex catalog diff --env test|prod
Target environment: test or prod
Publish
Publish catalog curation to remote environment.
dex catalog publish --env test|prod [--dry-run]
Target environment: test or prod
Preview publish operation without making changes
Pull
Pull catalog curation from remote environment.
dex catalog pull --env test|prod
Source environment: test or prod
Seasons
Manage catalog seasons configuration.
dex catalog seasons list
dex catalog seasons get --season S2
dex catalog seasons set --season S3 --label "season 3 ('26-)" --order 3
dex catalog seasons teaser enable --season S3
dex catalog seasons teaser disable --season S3
dex catalog seasons teaser set --season S3 --count 1 --message "this artist has not been announced yet" --tokens "???,!!!,***,@@@" --style redacted
Global Flags
Path to catalog.editorial.json file (overrides default)
Examples
Add entry to catalog
dex catalog manifest add --entry john-doe --lookup LOOKUP-0042 --season S2 --instrument "Piano" --performer "John Doe"
Validate and publish to test
dex catalog validate
dex catalog diff --env test
dex catalog publish --env test
Retire an entry
dex catalog manifest retire --entry john-doe
Set spotlight
dex catalog spotlight set --entry jane-smith --headline "Featured Artist" --cta-label "Explore Collection"
See Also
- dex home - Manage home featured entries
- dex entry - Entry audit and linkage operations