Skip to content

About this page

On this page

Environment variables ​

The toolchain config is file/CLI backed; a schema leaf opts into an environment variable with .meta({ envName: "..." }) (see the Config Generator).

VariableScopeDefaultDescription
DBX_PROJECT_REGENERATEtoolchain—Regenerate this section's managed files during dbx sync. When false, existing files are left untouched and are neither written nor drift-checked.
DBX_PROJECT_NAMEtoolchain—The unscoped project name (written as <scope>/<name>).
DBX_PROJECT_SCOPEtoolchain—The npm scope, eg. @org.
DBX_PROJECT_AUTHORtoolchain—Package author (package.json author).
DBX_PROJECT_LICENSEtoolchain—SPDX license id (package.json license).
DBX_PROJECT_HOMEPAGEtoolchain—Project homepage (package.json homepage).
DBX_PROJECT_REPOtoolchain—Repository URL (package.json repository). For a workspace it also resolves to the workspace path (repository.directory).
DBX_PROJECT_NODEVERSIONtoolchain—Node version for CI/templates, eg. 22 (not package.json engines).
DBX_PROJECT_PACKAGEMANAGERtoolchainyarnPackage manager name, written as <name>@<version>.
DBX_PROJECT_PACKAGEMANAGERVERSIONtoolchain—Package manager version, eg. 4.17.1.
DBX_PROJECT_DESCRIPTIONtoolchain—One-line description (package.json description).
DBX_PROJECT_INHERITtoolchaintrueInherit the parent project metadata. Set false to keep this project metadata independent of the root config (other sections still merge normally).
DBX_PROJECT_MANAGECONFIGLESStoolchainfalseManage projects that have no dbx.config.* of their own by inheriting the nearest ancestor config. Disabled by default so configless projects are never touched unless explicitly opted in.
DBX_CItoolchain{}GitHub Actions workflows to generate (CI, release, issues, changelog, sync).
DBX_CHANGELOGtoolchain{}Manual changelog pipeline options for dbx changelog, the VS Code actions and the API. ci.changelog inherits these options.
DBX_FMTtoolchain{}Formatter configuration: Oxc/Biome options, editor defaults and tools.
DBX_LINTtoolchain{}Linter configuration: Oxc/Biome/ESLint options and editor defaults.
DBX_BIOMEtoolchain{}Biome config generation (for consumers that still want a biome.json).
DBX_TSCONFIGtoolchain{}Workspace tsconfig generation (path aliases + project references).
DBX_LOADERtoolchain{}How dbx.config.* files are imported (tsconfig discovery).
DBX_TEMPLATEStoolchain{}Template sources / scaffolding.
DBX_REGISTRYtoolchain{}Allow/deny host and path globs for template/provider registries.
DBX_CATALOGStoolchain{}Package catalogs written to the package manager catalog file (catalog:).
DBX_VITEtoolchain{}The full Vite+ config; dbx sync writes the root vite.config.ts from it.
DBX_WATCHtoolchain{}Watch behaviour for dbx watch.
DBX_SYNCtoolchain{}dbx sync behaviour (formatting of the generated managed files).
DBX_LOGGERtoolchain{}Logging level, colours and prefix for toolchain output.
DBX_PROVIDERStoolchain{}Provider command behaviour (eg. colour for the passthrough commands).
DBX_MCPtoolchain{}Install the official dbx skill (and MCP helpers) into AI agent harnesses.