Configuration

All Docvia settings live in docvia.config.ts at your project root. The defineConfig helper provides type safety and sensible defaults.

Minimal config

import { defineConfig } from "@docvia/cli";
import { createSvelteRenderer } from "@docvia/renderer-svelte/node";

export default defineConfig({
  sourceDir: "src/docs",
  renderer: createSvelteRenderer(),
});

Full reference

Field	Type	Default	Description
`sourceDir`	`string`	`"docs"`	Markdown source directory
`outDir`	`string`	`".docvia"`	Output directory for the generated module graph
`renderer`	`RendererAdapter`	—	Framework renderer (required for builds)
`collections`	`CollectionConfig[]`	Auto	Multi-collection setup
`components`	`Record<string, ComponentConfig>`	`{}`	Interactive component registry
`frontmatter`	`ZodObject`	—	Extend built-in frontmatter fields
`plugins`	`docviaPlugin[]`	`[]`	Build-time transform plugins

Custom frontmatter

Extend the built-in schema with Zod. Built-in fields (title, description, tags, order, slug, draft) are always available; your extensions are merged and validated at build time.

import { z } from "zod";

export default defineConfig({
  frontmatter: z.object({
    author: z.string().optional(),
    category: z.enum(["guide", "reference"]).optional(),
  }),
});

Syntax highlighting

Syntax highlighting is a build-time plugin from @docvia/plugin-shiki. It highlights every code block during compilation and bakes the HTML into the IR, so no highlighter ships to the browser.

import { shiki } from "@docvia/plugin-shiki";

export default defineConfig({
  // ...
  plugins: [
    shiki({
      theme: "dracula",
      langs: ["typescript", "svelte", "bash", "json", "css", "html"],
    }),
  ],
});

Vite integration

vite.config.ts needs the single docvia() plugin. It runs the compiler in-process — compilation happens during dev and build, with no separate step.

import { docvia } from "@docvia/plugin-vite";
import { sveltekit } from "@sveltejs/kit/vite";
import { defineConfig } from "vite";
import docviaConfig from "./docvia.config";

export default defineConfig({
  plugins: [sveltekit(), docvia(docviaConfig)],
});