# deltabox toolchain > All-in-one development toolchain that let's you scaffold projects, generate and manage configs, tsconfigs, custom templates, syncing, changelogs, CI, Vite+, migrations, and more. > If `https://toolchain.deltabox.studio` is unavailable, the same documentation is available in the repository at (source Markdown). This file is a concise, link-first overview. For the **full** documentation in a single file, see [`llms-full.txt`](https://toolchain.deltabox.studio/llms-full.txt). **How it works** — `@deltabox/toolchain` is a config-driven toolchain: - **One config.** `dbx.config.ts` exports `{ toolchain: { ...sections } }`; every section is opt-in by presence (`section: true` uses defaults, omit it to leave that area untouched). - **Sync.** `dbx sync` runs each enabled section and writes the managed files, tracked in `.dbx/toolchain/manifest.json` (the last-sync time lives in the gitignored `.dbx/toolchain/timestamps.json`); `dbx sync --check` is the CI gate. `dbx sync --recursive` syncs every discovered project in dependency order. - **Nested configs.** A non-root `dbx.config.*` only inherits sections it explicitly enables (`fmt`, `lint`, `biome`, `changelog`, `catalogs`, `logger`); `project` metadata is inherited except its identity fields. `ci`, `tsconfig`, `loader`, `templates`, `registry`, `watch`, `providers`, `vite` and `hooks` are never inherited. Configless projects are unmanaged unless `project.manageConfigless` / `--configless` opts in. - **Project graph.** `dbx projects` writes `.dbx/toolchain/projects.json` (workspace dirs + dependencies), used by `sync --recursive`, the VS Code view and per-workspace changelogs. - **Vite plugin.** `dbx()` in `vite.config.*` can carry the whole toolchain config, so a Vite/Vite+ project needs no `dbx.config.*`; the CLI reads the plugin options back. dbx never manages `vite.config.*` in plugin mode, and Vite+ passthrough commands are gated on Vite+ being detected. - **MCP.** `dbx mcp:serve` exposes every public dbx API over MCP; `dbx mcp:install` writes the server + skill for Claude, Codex, VS Code, OpenCode, Pi or a custom directory. - **Sections.** `project`, `ci` (workflows + changelog), `fmt`, `lint`, `biome`, `tsconfig`, `loader`, `templates`, `vite`, `watch`, `logger`, `providers`; every workflow under `ci` is opt-in. - **Runtime.** Node ≥ 22.22.1 (or ≥ 24.11.0) and Yarn 4 (corepack); Vite+ (`vp`) resolves at the repo root. ## Table of Contents ### Introduction - [Getting started](https://toolchain.deltabox.studio/guide.md) - [Why use this?](https://toolchain.deltabox.studio/guide/why-use-this.md) ### Configuration #### Config reference - [Overview](https://toolchain.deltabox.studio/config.md) - [CLI reference](https://toolchain.deltabox.studio/config/cli.md) - [Environment variables](https://toolchain.deltabox.studio/config/env.md) - [dbx.config](https://toolchain.deltabox.studio/config/reference.md) #### Config generator - [Config generator](https://toolchain.deltabox.studio/guide/config-generator.md) - [Describe a scope](https://toolchain.deltabox.studio/guide/config-generator/describe-a-scope.md) - [Create the engine](https://toolchain.deltabox.studio/guide/config-generator/create-the-engine.md) - [Generate](https://toolchain.deltabox.studio/guide/config-generator/generate.md) - [CLI commands docs](https://toolchain.deltabox.studio/guide/config-generator/cli-commands.md) - [Load the config at runtime](https://toolchain.deltabox.studio/guide/config-generator/load-the-config.md) - [Generated outputs](https://toolchain.deltabox.studio/guide/config-generator/generated-outputs.md) - [Client and server configs](https://toolchain.deltabox.studio/guide/config-generator/client-and-server.md) - [Real-world shape](https://toolchain.deltabox.studio/guide/config-generator/real-world-shape.md) - [API reference](https://toolchain.deltabox.studio/guide/config-generator/api.md) #### Configuration guide - [Configuration guide](https://toolchain.deltabox.studio/guide/config.md) - [Config file names](https://toolchain.deltabox.studio/guide/config/config-file-names.md) - [`defineConfig`](https://toolchain.deltabox.studio/guide/config/defineconfig.md) - [Hooks](https://toolchain.deltabox.studio/guide/config/hooks.md) - [Loader](https://toolchain.deltabox.studio/guide/config/loader.md) - [Logging](https://toolchain.deltabox.studio/guide/config/logging.md) - [Nested configs](https://toolchain.deltabox.studio/guide/config/nested-configs.md) - [Opt-in by presence](https://toolchain.deltabox.studio/guide/config/opt-in-by-presence.md) - [Programmatic config API](https://toolchain.deltabox.studio/guide/config/programmatic-api.md) - [Provider config](https://toolchain.deltabox.studio/guide/config/providers.md) - [Vite+ config](https://toolchain.deltabox.studio/guide/config/vite.md) ### Project & templates - [Monorepo guide](https://toolchain.deltabox.studio/guide/monorepo.md) - [Project](https://toolchain.deltabox.studio/guide/project.md) - [TypeScript](https://toolchain.deltabox.studio/guide/typescript.md) - [tsconfig](https://toolchain.deltabox.studio/guide/tsconfig.md) - [Package catalogs](https://toolchain.deltabox.studio/guide/catalogs.md) - [Templates](https://toolchain.deltabox.studio/guide/templates.md) - [Template and registry structures](https://toolchain.deltabox.studio/guide/template-structures.md) ### Toolchain - [Vite+](https://toolchain.deltabox.studio/guide/vite.md) - [Vite plugin](https://toolchain.deltabox.studio/guide/vite-plugin.md) - [VS Code extension](https://toolchain.deltabox.studio/guide/vscode.md) - [Providers](https://toolchain.deltabox.studio/guide/providers.md) - [Formatting & linting](https://toolchain.deltabox.studio/guide/formatting.md) - [Package scripts](https://toolchain.deltabox.studio/guide/scripts.md) - [CLI](https://toolchain.deltabox.studio/guide/cli.md) - [Docker](https://toolchain.deltabox.studio/guide/docker.md) - [MCP (Model Context Protocol)](https://toolchain.deltabox.studio/guide/mcp.md) - [Logger](https://toolchain.deltabox.studio/guide/logger.md) - [Watch](https://toolchain.deltabox.studio/guide/watch.md) ### Automation & API #### Changelog - [Changelog](https://toolchain.deltabox.studio/guide/changelog.md) - [Branches](https://toolchain.deltabox.studio/guide/changelog/branches.md) - [CLI](https://toolchain.deltabox.studio/guide/changelog/cli.md) - [commitlint](https://toolchain.deltabox.studio/guide/changelog/commitlint.md) - [Intro and outro text](https://toolchain.deltabox.studio/guide/changelog/intro-outro.md) - [Release bodies](https://toolchain.deltabox.studio/guide/changelog/release.md) - [Troubleshooting](https://toolchain.deltabox.studio/guide/changelog/troubleshooting.md) - [Versioning](https://toolchain.deltabox.studio/guide/changelog/versioning.md) - [Writing commit messages](https://toolchain.deltabox.studio/guide/changelog/writing-commit-messages.md) #### CI - [CI](https://toolchain.deltabox.studio/guide/ci.md) - [Changelog workflow](https://toolchain.deltabox.studio/guide/ci/changelog.md) - [CI checks](https://toolchain.deltabox.studio/guide/ci/ci.md) - [Dependabot](https://toolchain.deltabox.studio/guide/ci/dependabot.md) - [Issues](https://toolchain.deltabox.studio/guide/ci/issues.md) - [Releases](https://toolchain.deltabox.studio/guide/ci/releases.md) - [Workflow settings](https://toolchain.deltabox.studio/guide/ci/settings.md) - [Sync](https://toolchain.deltabox.studio/guide/ci/sync.md) #### Migrations - [Migrations](https://toolchain.deltabox.studio/guide/migrations.md) - [Migrating from v1 to v2](https://toolchain.deltabox.studio/guide/migrations/v1-v2.md) - [Migrating from v2 to v3](https://toolchain.deltabox.studio/guide/migrations/v2-v3.md) #### Programmatic API - [Programmatic API](https://toolchain.deltabox.studio/guide/api.md) - [Examples](https://toolchain.deltabox.studio/guide/api/examples.md) - [Logging](https://toolchain.deltabox.studio/guide/api/logging.md) - [Package reference](https://toolchain.deltabox.studio/guide/api/package-reference.md) - [Registering commands](https://toolchain.deltabox.studio/guide/api/registering-commands.md) - [Subpath exports](https://toolchain.deltabox.studio/guide/api/subpath-exports.md) - [Umbrella (`@deltabox/toolchain`)](https://toolchain.deltabox.studio/guide/api/umbrella.md) ### Contribute - [Overview](https://toolchain.deltabox.studio/contribute.md) - [Development](https://toolchain.deltabox.studio/contribute/development.md) - [Documentation](https://toolchain.deltabox.studio/contribute/documentation.md) ### LLMs - [LLMs](https://toolchain.deltabox.studio/llms.md) ### Other - [Changelog](https://toolchain.deltabox.studio/CHANGELOG.md)