Use it when you need fresh CSS and JSON; use brand_create to create a brand or brand_apply to change its source. Returns inline CSS variables, CSS and JSON plus artifact paths, hashes and sizes. apply:true builds in isolated artifact storage; omission previews the artifacts without writing. Requested brand/theme selects the inline scope; full CSS includes every registered scope. Source and shipped runtime files stay unchanged. Reference: TOOL-REFERENCE.md#tokens_build; full schema: oods://schemas/tokens_build.input.json.

Inputs

Name Type Required Description
brand string no Selects values compiled from current source, returned inline as CSS variables, CSS and JSON and written on apply. Full CSS includes all registered scopes; TypeScript and Tailwind artifacts retain A/light defaults.
theme "light" | "dark" | "hc" no Token theme.
apply boolean no Write on true; otherwise preview.

Outputs

The package ships no output schema for this tool.

A real call

Recorded by this site's tools run, step tokens-build, with the published OODS Foundry 0.10.1.

Its input:

{
  "brand": "A",
  "theme": "light"
}

Its result:

{
  "artifacts": [],
  "preview": {
    "summary": "Preview only: would return 5 token artifacts for brand A (light theme).",
    "notes": [
      "artifact: tokens.light.json",
      "artifact: tokens.scope.css",
      "artifact: tokens.css",
      "artifact: tokens.ts",
      "artifact: tokens.tailwind.json"
    ],
    "specimens": [
      "~/.oods-foundry/runtime/0.10.1-8f7d4c36f4a2/artifacts/current-state/2026-10-08/tokens.build/tokens.light.json",
      "~/.oods-foundry/runtime/0.10.1-8f7d4c36f4a2/artifacts/current-state/2026-10-08/tokens.build/tokens.scope.css",
      "~/.oods-foundry/runtime/0.10.1-8f7d4c36f4a2/artifacts/current-state/2026-10-08/tokens.build/tokens.css",
      "~/.oods-foundry/runtime/0.10.1-8f7d4c36f4a2/artifacts/current-state/2026-10-08/tokens.build/tokens.ts",
      "~/.oods-foundry/runtime/0.10.1-8f7d4c36f4a2/artifacts/current-state/2026-10-08/tokens.build/tokens.tailwind.json"
    ]
  }
}

The whole call, 1 KB of JSON