Two commands tell you what's different between your local [docs-as-code](/cli/overview/docs-as-code) files and the Doxbrix cloud — `dxb status` and `dxb diff` —...
Two commands tell you what's different between your local [docs-as-code](/cli/overview/docs-as-code) files and the Doxbrix cloud — `dxb status` and `dxb diff` —...
Two commands tell you what's different between your local docs-as-code files and the Doxbrix cloud — dxb status and dxb diff — and dxb push sends your local changes up.
dxb status
Start here. dxb status summarizes how your local files compare to the cloud:
dxb statusIt reports how many pages differ. For the detailed, page-by-page view, use dxb diff.
dxb push
dxb push sends your local changes to the cloud. It validates first, then uploads added, modified, and removed pages along with any docs.json changes.
# Send changes up (as drafts)
dxb push
# Send and publish every pushed page
dxb push --publishPush options
| Flag | Description |
|---|---|
| `--dry-run` | Report what would change without writing. |
| `--publish` | Publish every pushed page. |
| `--media` | Include media files (base64). |
| `--allow-orphans` | Push even if files aren't in `docs.json` (they won't publish). |
| `--strict` | Fail if any local file is missing from `docs.json`. |
# Preview a push without writing
dxb push --dry-run
# Strict publish for CI
dxb push --strict --publishdxb push --publish publishes to your live site. It respects governance policies — pages requiring approval won't go live until approved — but content that's free to publish goes live immediately. Use --dry-run or dxb diff first if you're unsure. Without --publish, pushed pages land as drafts.Orphans
A local .mdx file that isn't referenced in docs.json is an orphan — it won't publish. dxb push warns about orphans, and --strict fails on them. Wire them into navigation with dxb sync (or dxb new page) first.
A safe publish loop
dxb lint --strict to catch errors.
dxb status and dxb diff to see what will change.
dxb push --dry-run to confirm the change set.
dxb push --publish once it looks right.