VitePress

Quick Guide: VitePress is a Vue-powered static site generator built on Vite, designed for documentation. All config lives in .vitepress/config.ts. Use defineConfig() for type safety. Sidebar accepts arrays (single) or objects keyed by path prefix (multi-sidebar). Data loaders (*.data.ts) run at build time and ship only serialized results to the client. Vue components work directly in Markdown via <script setup>. Extend the default theme through layout slots and CSS variables rather than forking it.

Current stable version: VitePress 1.6.x (2026). Uses Vite 6+ and Vue 3.5+.

<critical_requirements>

CRITICAL: Before Using This Skill

All code must follow project conventions in CLAUDE.md

(You MUST use .vitepress/config.ts with defineConfig() for all site configuration — VitePress does not support config outside .vitepress/)

(You MUST use data loader files (*.data.ts) for build-time data — never fetch data at runtime in SSR-unsafe ways)

(You MUST handle SSR compatibility — no bare window, document, or browser APIs outside onMounted or <ClientOnly>)