Create pages & spaces

The CLI's authoring commands create spaces and pages and wire them into docs.json automatically. This is the blessed path for building structure: it keeps your files on disk and your navigation manifest in sync, so you never end up with orphan pages that don't appear on your site.

Create a space

A space is a top-level section (a top-bar entry on your site):

dxb space create "Guides" --slug guides

This adds the space to docs.json and creates its folder. Options:

List existing spaces with dxb space list (alias dxb space ls).

Create a page

dxb new page creates an .mdx file and references it in docs.json in one step:

dxb new page guides/quickstart --title "Quickstart"

This creates docs/guides/quickstart.mdx with frontmatter and adds a page entry to the nav.

Nested folders become groups

When the path has intermediate folders, the CLI creates the nesting as groups:

dxb new page guides/advanced/performance-tuning --title "Performance tuning"

This creates docs/guides/advanced/performance-tuning.mdx and nests it under an Advanced group inside the Guides space.

Hand-create, then sync

If you'd rather create files directly in your editor, write the .mdx files and then fold them into docs.json with dxb sync:

# Preview what sync would add (no changes)
dxb sync --dry-run

# Fold all orphan files into docs.json
dxb sync

# Force everything into one space (folders become groups)
dxb sync --space docs

dxb sync scans your base path for .mdx files not referenced in docs.json (orphans) and adds them with this mapping:

Moving, renaming, and removing

• Rename or move a page — move the .mdx file in your editor (or with git mv), then run dxb sync to re-wire it, or edit its entry in docs.json.
• Remove a nav entry — dxb nav remove guides/old-topic (alias rm) takes the page out of the navigation.

After moving published pages, consider adding a redirect so existing links keep working (see SEO & site layout).

Inspect structure

See the current navigation tree without opening docs.json:

dxb nav tree

Documentation (docs)
├─ Get started
│  ├─ Introduction
│  └─ Quickstart
└─ Guides
   └─ Advanced
      └─ Performance tuning

Next steps