--- title: "VitePress: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/jetbrains-vitepress/ description: "Documentation-site guidance for VitePress: .vitepress configuration, file-based routing and rewrites, Markdown extensions, Vue components inside Markdown, build-time data loaders, dynamic routes, theming, internationalization, SSR compatibility, and deployment recipes." --- # VitePress: review, setup & limitations · Undominated.ai > Documentation-site guidance for VitePress: .vitepress configuration, file-based routing and rewrites, Markdown extensions, Vue components inside Markdown, build-time data loaders, dynamic routes, theming, internationalization, SSR compatibility, and deployment recipes. [← Explore all skills](/skills/) WEB DEVELOPMENT / JetBrains # VitePress Documentation-site guidance for VitePress: .vitepress configuration, file-based routing and rewrites, Markdown extensions, Vue components inside Markdown, build-time data loaders, dynamic routes, theming, internationalization, SSR compatibility, and deployment recipes. [See setup guidance ↓](#setup)[Original source ↗](https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress) SOURCE REVIEW Reviewed 2026-10-07 Evidence 6 linked sources Publisher JetBrains Licence [MIT (upstream antfu/skills) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md) Revision e0f258b5cfed [Read what was—and wasn’t—checked ↓](#review) “VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.” [JetBrains · upstream description ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/SKILL.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Covers the documentation-site generator end to end — config, file-based routing, Markdown containers and includes, Vue-in-Markdown, data loaders, dynamic routes — each routed to its own reference file. - Includes the operational topics docs sites actually need: deployment recipes for GitHub Pages, Netlify, Vercel, Cloudflare and Nginx, locale configuration for multi-language sites, and SSR compatibility via ClientOnly and dynamic imports. - Generated from the official vuejs/vitepress manual by a Vite core-team author, so the reference tree tracks upstream documentation rather than blog folklore. ### A good fit for - Standing up or restructuring a VitePress documentation site with the default theme - Adding search, navigation, social links and locale configuration without fighting the theme system - Extending Markdown with Vue components and build-time data loaders ### Weigh up before choosing - The mirror generation is dated 2026-01-28 and based on VitePress 1.x; the upstream generator has since produced a VitePress 2.0.0-alpha.20 revision (2026-09-25). - Vue-flavoured: assumes Vue 3 single-file component knowledge for the customization references. - Reference-index style; no worked site is included. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - vitepress/SKILL.md (JetBrains mirror) - vitepress/references directory listing (14 files) - upstream antfu/skills skills/vitepress/SKILL.md - upstream LICENSE.md - JetBrains/skills README mirror policy ### Our findings - All 14 reference links resolve to files present in the mirror's references directory, verified against the listing. - Front matter credits antfu/skills generated from vuejs/vitepress; the mirror snapshot is VitePress 1.x (2026-01-28) while upstream has regenerated against 2.0.0-alpha.20. - The theme section separates theme configuration, customization of the default theme, and building a custom theme from scratch — three distinct jobs that generic docs guidance conflates. ### Not established by this review - No documentation site was built or deployed with this skill. - Deployment recipes were read, not exercised against any host. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Add a skill to your workflow. [Upstream setup instructions ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) DOCUMENTED COMMAND npx skills add JetBrains/skills/vitepress --skill vitepress Copy command ↗ Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above. Optional: install the reviewed revision Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose. npx skills add https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress --skill vitepress Copy reviewed-revision command ↗ - Install the complete skill directory with its references. - Bring the existing .vitepress directory or the content plan for the new site. ### Before you start - Node.js/npm for the installer - An agent that supports the Agent Skills format - A VitePress project or planned documentation site ### Compatibility Agent Skills-compatible coding agents · VitePress 1.x sites · Vue 3 for component-level customization ### Reads .vitepress config and Markdown content; writes site configuration and docs - Read .vitepress configuration, theme files and Markdown content - Write site configuration, theme overrides and documentation pages - Run dev or build commands only when the user asks ### Cost model MIT-licensed instruction package; site builds cost only local machine time. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Skill definition at reviewed revision ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/SKILL.md) Checked 2026-10-07 https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access - [Reference directory listing at reviewed revision (14 documents) ↗](https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/references) Checked 2026-10-07 https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/references Supports: review, whySelected - [Upstream skill definition (origin of the mirrored content) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/vitepress/SKILL.md) Checked 2026-10-07 https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/vitepress/SKILL.md Supports: review, limitations - [Upstream license (MIT) ↗](https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md) Checked 2026-10-07 https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md Supports: license - [Mirror policy: JetBrains-filtered, JetBrains-verified snapshot with source links and CI skill scanning ↗](https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md) Checked 2026-10-07 https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md Supports: review, install, limitations - [Skills installer source formats and selective installation ↗](https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md) Checked 2026-10-07 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Matt Pocock Codebase Design ↗ Evaluates module boundaries through caller complexity, dependency seams and alternative interface designs.](/skills/mattpocock-codebase-design/)[### Modern Web Guidance ↗ Routes HTML, CSS and client-side JavaScript work through a searchable corpus of Chrome-authored best-practice guides — container queries, dialogs and popovers, view transitions, scroll-driven animation, forms and autofill, image priority — with Baseline browser-support policy rules for fallbacks.](/skills/jetbrains-modern-web-guidance/)[### Vercel React Best Practices ↗ Organizes React and Next.js performance reviews around request waterfalls, bundles, server work and rendering costs.](/skills/vercel-labs-react-best-practices/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Choose a toolkit](/tools/) - [Inspect execution hosts](/agents/) - [Check tool access](/mcp-servers/) - [Check project dependencies](/check-repo/)