Skip to content

CLI ​

The dbx binary is composed from framework-agnostic command descriptors. Commands that run against a project load its dbx.config.ts first, so config-derived defaults apply unless you override them on the command line.

Core ​

CommandDescription
projectsDiscover projects and write .dbx/toolchain/projects.json.
syncRegenerate every managed file (--check, --recursive, --watch, --force).
watchSync once, then watch key inputs and re-sync.
resetRemove generated files, the manifest and/or the config (--all, --recursive).
providersList registered providers + their commands (--json).

Scaffolding ​

CommandDescription
project:initA single-package TypeScript project.
project:init:monorepoA monorepo root + one example workspace.
project:init:workspaceA workspace package into an existing monorepo root.
project:configGenerate dbx.config.ts for projects missing one.
createScaffold from a template (--template/--kind, --name, --scope, --out).

Templates ​

CommandDescription
template:listList templates (--kind, --registry, --online, --json).
template:initWrite a template.json to a directory (--kind, --name, --add).
template:addRecord a source in .dbx/toolchain/templates.json (auto-inits local).
template:removeRemove a source by id or type:locate.
template:infoShow one template.

See Templates.

Migrations ​

bash
dbx migrate --from biome --write           # .oxfmtrc.json + .oxlintrc.json
dbx migrate --from biome --target vite --write
dbx migrate --from all                     # every detected source
dbx migrate --check                        # CI: exit 1 when stale
dbx migrate:list

See Migrations.

Tsconfig / cleanup / changelog / workflows ​

CommandDescription
tsconfigRegenerate workspace tsconfig.json files.
cleanup / cleanup:turboRemove build artifacts / the turbo cache.
changelogDerive the semver bump and update CHANGELOG + versions.
workflowTrigger generated GitHub workflows via gh workflow run.

Providers ​

Every provider subcommand is a passthrough. For Vite+:

bash
dbx vite dev            # forwards to `vp dev`
dbx vite add zod        # forwards to `vp add zod`
dbx vite:build          # named alias for `vp build`

The generic vite command forwards its operands verbatim to vp, so every Vite+ CLI command and flag is reachable.

Config generator ​

The generic Zod/env config engine is not a dbx command: a consumer builds an engine with createConfigEngine and registers the config:* commands on its own CLI. See Config Generator.