wiki-vitepress

Topics in the source

• Wiki VitePress Packager
• When to Activate
• VitePress Scaffolding
• Config Requirements (config.mts)
• Dark-Mode Mermaid: Three-Layer Fix
• Layer 1: Theme Variables (in config.mts)
• Layer 2: CSS Overrides (custom.css)
• Layer 3: Inline Style Replacement (theme/index.ts)

Transform generated wiki Markdown files into a polished VitePress static site with dark theme and interactive Mermaid diagrams. User asks to "build a site" or "package as VitePress" User runs the /deep-wiki:build command User wants a browsable HTML output from generated wiki pages Generate the following structure in a wiki-site/ directory: Use withMermaid wrapper from vitepress-plugin-mermaid Set appearance: 'dark' for dark-only theme Configure themeConfig.nav and themeConfig.sidebar from the catalogue structure Mermaid config must set dark theme variables: Set via mermaid.themeVariables as shown above. Target Mermaid SVG elements with !important: Mermaid inline style attributes override everything. Use onMounted + polling to replace them: Use setup() with onMounted, NOT enhanceApp() — DOM doesn't exist during SSR. Wrap each .mermaid container in a clickable wrapper that opens a fullscreen modal: Modal CSS: Before VitePress build, scan all .md files and fix: Replace with (Vue template compiler compatibility) Wrap bare generic parameters in backticks outside code fences Ensure every page has YAML frontmatter with title and description Output goes to wiki-site/.vitepress/dist/. Merma

This is an excerpt. Refer to the complete source and its current requirements.