Setup Preset Generator
Interactive helper to generate setup presets for create-zudo-doc.
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.
Project Name
Default Language
Color Scheme Mode
Color Scheme
Theme Pack
Features
Header right items
Markdown Options
Package Manager
Languages
The Default language select chooses the primary locale and controls the unprefixed / 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:
{
"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 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 and preview changes live with the Design Token Panel's Palette tab (see Color Scheme Preview).
Header right items
The "Header right items" section configures the headerRightItems field — the right-side cluster of the site header (theme toggle, 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 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(andtwitter: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:cardblock. Off by default; enabling it reveals a card-type selector (summary/summary_large_image) and optionaltwitter:site/twitter:creatorhandle 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.
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.
Footer taglist — render the global tag cloud in the site footer. See 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 makesrobots.txtreturnDisallow: /. See Avoid Robots Indexing.