yaakdoc

Kiseki

The default theme, built with Tailwind CSS v4 and shadcn/ui.

Kiseki (奇跡, "miracle") is the default yaakdoc theme. It's built with Tailwind CSS v4 and shadcn/ui components (Radix UI and Lucide icons). It uses Geist fonts that are bundled locally, so it makes no external requests.

See it live.

  • Light and dark mode, following the system setting until the reader picks one.
  • A sticky, dark code panel next to each request, with tabs per language and per response.
  • Navigation tabs, collapsible groups and Lucide icons.
  • Search with Cmd+K, and an environment switcher.
  • "Copy page", "View as Markdown" and "Open in ChatGPT/Claude" actions.

Options

yaakdoc.config.json
{
  "theme": "kiseki",
  "themeOptions": {
    "codePanel": "right",
    "sidebarWidth": "18rem",
    "navOpenDepth": 2,
    "showEnvironment": true
  }
}
OptionDefaultDescription
codePanel"right""right" puts code examples in a sticky column on wide screens. "inline" puts them below each request.
sidebarWidth"18rem"Any CSS length.
navOpenDepth2Folder levels expanded in the navigation by default. Folders that contain the current page or section are always open.
showEnvironmenttrueShow the environment used for the examples in the header.
  • Tabs. With several navigation tabs, they're shown under the header, and the sidebar shows the current tab.
  • Groups. Top-level groups are titled sections. Nested groups collapse.
  • Icons. icon on pages, groups and tabs takes a Lucide icon name, such as book-open or key-round.
  • Search. Press Cmd+K / Ctrl+K or /, or use the search button in the sidebar. With "search": false, the sidebar shows a filter instead.

Customizing

  • Colors and fonts. Use branding.colors and branding.fonts. They feed the shadcn-style tokens in Kiseki's src/styles.css.
  • Small CSS tweaks. Use branding.customCss.
  • Everything else. Eject the theme. Its shadcn config (components.json) is copied too, and @/... imports resolve to theme/src, so components copied from shadcn/ui work as they are.

On this page