Skip to main content

​
Overview

The dex home command manages the home page featured entries list and publishes home curation to test and production environments.

​
Usage

dex home <featured|validate|diff|publish|pull> [args]

​
Subcommands

Manage the home page featured entries.
List current featured entries.
dex home featured list
Output shows slot index, entry ID, lookup number, and video status for each featured entry.

​
Validate

Validate home featured entries and write snapshot. 
dex home validate [--catalog-file data/catalog.editorial.json]
​
--catalog-file
string
Path to catalog.editorial.json for cross-validation
Validation checks:
  • All featured entries exist in catalog manifest
  • Schema compliance

​
Diff

Compare local home configuration with remote environment. 
dex home diff --env test|prod
​
--env
string
required
Target environment: test or prod
​
--api-base
string
Override API base URL
​
--token
string
Override admin token

​
Publish

Publish home featured entries to remote environment. 
dex home publish --env test|prod [--dry-run]
​
--env
string
required
Target environment: test or prod
​
--dry-run
boolean
Preview publish operation without making changes
​
--api-base
string
Override API base URL
​
--token
string
Override admin token

​
Pull

Pull home configuration from remote environment. 
dex home pull --env test|prod
​
--env
string
required
Source environment: test or prod
​
--api-base
string
Override API base URL
​
--token
string
Override admin token

​
Global Flags

​
--file
string
Path to home.featured.json file (overrides default)

​
Examples

dex home featured set --entries "john-doe,jane-smith,bob-jones"

​
Validate and publish to test

dex home validate
dex home diff --env test
dex home publish --env test

dex home featured reorder --entries "jane-smith,john-doe,bob-jones"

​
Dry run publish to production

dex home publish --env prod --dry-run

​
Workflow

1

Update featured list

Set or reorder the featured entries using dex home featured set or reorder
2

Validate

Run dex home validate to ensure all entries are valid and exist in catalog
3

Review changes

Use dex home diff --env test to see what will change
4

Publish to test

Deploy to test environment: dex home publish --env test
5

Publish to production

After testing, deploy to production: dex home publish --env prod

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us