[Tools](https://oods-foundry.com/tools) / tokens_build

# `tokens_build`

Compile registered brand tokens with the shipped compiler.

Generated from @oods/foundry 0.10.1

One of the 20 tools your assistant sees by default.

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](https://oods-foundry.com/tools/tokens-build/call.json)