Skip to main content
This workflow ensures that protected assets, catalog entries, and home featured content are properly validated before publication.

​
Overview

The catalog curation workflow validates:
  • Protected asset coverage for all active entries
  • Catalog manifest integrity and linkage
  • Home featured entry configuration
  • Cross-reference consistency between systems

​
Workflow Steps

1

Validate protected assets

Run the protected assets validation to ensure all active catalog lookups have complete coverage:
dex assets validate
This checks:
  • Asset file existence and accessibility
  • Coverage for all active catalog entries
  • Mapping integrity in data/protected.assets.json
Missing asset coverage will block publication. Ensure all active entries have complete protected asset mappings.
2

Validate catalog and home featured

Run validation for both catalog and home systems:
dex catalog validate
dex home validate
Catalog validation checks:
  • Manifest entry integrity
  • Lookup token uniqueness
  • Season/performer/instrument metadata
  • Entry status consistency
Home validation checks:
  • Featured entry references are valid
  • All featured entries exist in catalog
  • Featured list order and completeness
3

Diff test environment before publish

Compare local state with the test environment to preview changes:
dex assets diff --env test
dex catalog diff --env test
dex home diff --env test
Review the diff output carefully:
  • Additions: new entries or assets
  • Modifications: updated metadata or content
  • Deletions: removed or archived items
Review all diffs carefully before proceeding to publish. Unexpected changes may indicate configuration drift or errors.

​
Stop Conditions

Halt the workflow if any of these conditions occur:
  • Missing coverage for active lookups in protected assets
  • Linkage validation failures in catalog or home
  • Snapshot validation errors
  • Unexpected or unexplained diffs in test environment
Do not proceed to publication until all validation errors are resolved.

​
Verification Commands

Use these commands to verify curation state: 
# Validate all systems
dex assets validate
dex catalog validate
dex home validate

# Diff against test environment
dex assets diff --env test
dex catalog diff --env test
dex home diff --env test

# Diff against production (read-only check)
dex assets diff --env prod
dex catalog diff --env prod
dex home diff --env prod

​
Catalog Management

​
Adding entries to catalog manifest

Use the catalog manager from the dashboard or CLI: 
# Add entry to manifest
dex catalog manifest add --entry <slug> --lookup <lookup> --season S2 --instrument piano --performer "Artist Name"

# Edit existing manifest entry
dex catalog manifest edit --entry <slug> --status active

# Stage entry for publication
dex catalog stage --entry <slug>

# Set featured entries list (comma-separated IDs)
dex home featured set --entries <id1>,<id2>,<id3>

# Reorder featured entries
dex home featured reorder --entries <id3>,<id1>,<id2>

# List current featured entries
dex home featured list

​
Next Steps

After successful curation validation:

Release Process

Run preflight and publish to test/prod environments

Entry Validation

Validate additional entries before adding to catalog

​
Troubleshooting

​
Preflight fails on missing protected coverage

Symptom: preflight failed: missing protected asset coverage (...) Fix:
  1. Inspect coverage: 
    dex assets validate
dex entry audit --all --inventory-only
  2. Add missing mappings in protected assets manager (TUI) or update data/protected.assets.json
  3. Re-run preflight: 
    dex release preflight --env test

​
Catalog linkage validation failure

Symptom: Catalog validate reports broken entry references or missing lookups. Fix:
  1. Check catalog manifest for invalid entry IDs
  2. Verify all referenced entries exist and are not archived
  3. Ensure lookup tokens are unique and properly formatted
  4. Re-run validation after corrections

Build docs developers (and LLMs) love

Get started for freeTalk to us