Use this interactive tool to configure your zudo-doc project options and generate a setup preset. You can copy the output as JSON for the programmatic API, or as a CLI command for terminal usage.

[Dynamic content unavailable in text export]

## Languages

The **Default language** select chooses the primary locale and controls the unprefixed `/docs/...` routes. **Additional language codes** accepts a comma-separated, ordered list such as `ja, de`. A non-empty list automatically adds i18n and becomes the complete `additionalLangs` array in the generated preset; it is not limited to Japanese or to one additional locale.

Leave the field blank for a single-language preset. Blank input omits `additionalLangs` and does not add `i18n` to `features`. Codes are normalized to lowercase and validated before generation; duplicates, the selected default code, path traversal, separators, and other unsafe values show an inline error and disable **Generate Preset**.

The generated dialog can show both representations of the same hydrated form state. This abbreviated JSON focuses on the locale fields; the real preset may include your other feature choices:

```json
{
  "defaultLang": "en",
  "additionalLangs": ["ja", "de"],
  "features": ["i18n"]
}
```

Use the **as CLI command** checkbox to copy the equivalent `--lang en --additional-langs ja,de --i18n` flags. The CLI list replaces a preset's list when both are supplied; it does not append to it. See the [i18n guide](https://zudo-doc.takazudomodular.com/docs/guides/i18n) for legacy boolean inference and the explicit `--no-i18n` warning.

## Color Scheme

The generator ships exactly two bundled color schemes — `Default Light` and `Default Dark` — sharing one set of OKLCH ramps. In **Single scheme** mode, the dropdown lets you pick either one. In **Light & Dark (toggle)** mode, the pairing is fixed to `Default Light` / `Default Dark` — there is no scheme dropdown to pick a different pairing, only the default-mode and respect-system-preference options.

To customize the palette beyond these two starting points, write your own `colorSchemes` override module (with your own ramps and semantic map) after scaffolding and pass it via the `colorSchemes` field in `zfb.config.ts` — see [Adding a Custom Color Scheme](https://zudo-doc.takazudomodular.com/docs/reference/color#adding-a-custom-color-scheme) and preview changes live with the [Design Token Panel](https://zudo-doc.takazudomodular.com/docs/reference/design-token-panel)'s Palette tab (see [Color Scheme Preview](https://zudo-doc.takazudomodular.com/docs/guides/color-scheme-preview)).

## Header right items

The "Header right items" section configures the `headerRightItems` field — the right-side cluster of the site header (appearance menu, language switcher, version switcher, GitHub link, and the Design Token Panel / AI Chat triggers). Toggle each item on or off, and use the up/down buttons to change render order.

Two item kinds — `link` (custom external link) and `html` (raw HTML) — are intentionally not exposed in the UI. Add those by editing `zfb.config.ts` directly after scaffolding. See [Header Right Items](https://zudo-doc.takazudomodular.com/docs/guides/header-right-items) for the full discriminated-union schema and examples.

## Meta tags

The "Meta tags" section configures the `metaTags` field — which meta tags are emitted in each page's `<head>`. The available options are:

- **SEO description meta** — emit `<meta name="description">`. On by default.
- **Keywords** — emit `<meta name="keywords">` with a comma-separated list you provide. Off by default; enabling it reveals a text input.
- **OGP image (og:image)** — emit `og:image` (and `twitter:image`). Off by default; enabling it reveals a path input defaulting to `/img/ogp.png`.
- **og:site_name** — emit `og:site_name`. On by default.
- **Twitter card** — emit the `twitter:card` block. Off by default; enabling it reveals a card-type selector (`summary` / `summary_large_image`) and optional `twitter:site` / `twitter:creator` handle inputs.

`og:title` is always emitted and is not listed here — it is a DocHead contract that cannot be disabled via this setting.

## Additional features

The Features section also includes:

- **Image enlarge** — click-to-zoom for content images. Enabled by default.
- **Tag governance** — vocabulary-rule audit for tags. See [Tag governance](https://zudo-doc.takazudomodular.com/docs/guides/tag-governance).
- **Body foot util area** — slot at the bottom of the article body for util widgets like a tag list or feedback link. See [Body foot util area](https://zudo-doc.takazudomodular.com/docs/guides/body-foot-util-area).
- **Footer taglist** — render the global tag cloud in the site footer. See [Footer taglist](https://zudo-doc.takazudomodular.com/docs/guides/footer-taglist).
- **Design Token Panel** — interactive tabbed panel for tweaking spacing, font, size, and color tokens. The setting key is `designTokenPanel`.
- **Avoid robots indexing** — sets `noindex: true`, which emits `<meta name="robots" content="noindex, nofollow">` on every page and makes `robots.txt` return `Disallow: /`. See [Avoid Robots Indexing](https://zudo-doc.takazudomodular.com/docs/guides/avoid-robots-indexing).