{
 "slug": "vitepress",
 "name": "VitePress",
 "author": "Vue.js",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Vite + Vue static site generator with a default docs theme and a home/landing layout.",
 "category": {
  "slug": "page-templates",
  "name": "Page and site templates"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/vuejs.png",
 "logo_letter": "V",
 "links": {
  "repo": "https://github.com/vuejs/vitepress",
  "website": "https://vitepress.dev",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
   "note": "MIT allows use in paid products and client sites free of charge.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install vitepress. No key or account is needed.",
   "source": {
    "label": "github.com/vuejs/vitepress",
    "url": "https://github.com/vuejs/vitepress"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE",
  "summary": "Free for personal and paid sites, and no visible credit on the site is needed. Keep the copyright and license notice if you pass the VitePress code itself on.",
  "pages_read": 1,
  "rules": [
   "Keep the MIT copyright notice in the code if you redistribute it.",
   "No visible credit on the site is required by the licence."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-09",
  "commercial_use_page": "https://agentgid.com/assets/vitepress/commercial-use/"
 },
 "overview": {
  "heading": "VitePress: a docs site from plain text files",
  "body": "VitePress turns a folder of simple Markdown text files into a fast, finished website. It comes with a ready design for documentation, with a menu, sidebar, search and dark mode, plus a home page with a big headline and feature boxes. The result is plain web pages you can host almost anywhere, often for free."
 },
 "uses": [
  {
   "title": "Documentation for your product",
   "text": "Write help pages and guides as text files and get a docs site with a sidebar, page links and code examples that look tidy.",
   "idea": false,
   "image": null
  },
  {
   "title": "Search inside your docs",
   "text": "Visitors search all pages from a box at the top. The search runs in their browser, with no outside service or account.",
   "idea": false,
   "image": null
  },
  {
   "title": "A landing page for a project",
   "text": "Give a library or app a front page with a big headline, buttons and a row of feature boxes. It is set up in a few lines at the top of one file.",
   "idea": false,
   "image": null
  },
  {
   "title": "A blog or portfolio",
   "text": "Use your own design on top of the same engine for a blog, a portfolio or a small marketing site.",
   "idea": false,
   "image": null
  },
  {
   "title": "Docs in several languages",
   "text": "Keep each language in its own folder, such as es or fr, and visitors switch between them from the menu.",
   "idea": false,
   "image": null
  },
  {
   "title": "Free hosting with a sitemap",
   "text": "Publish the finished pages on GitHub Pages or a similar free host and let search engines find every page through a sitemap file.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add VitePress 1.6.4 to this project in a docs folder, set the site title and description, turn on local search and a sitemap for https://example.com, and set base to '/repo/' for GitHub Pages.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Make sure Node.js is installed (version 22 or newer for the version the current docs describe), then add VitePress to the project.",
    "source": "$ npm add -D vitepress@next"
   },
   {
    "tab": "Step 2",
    "intro": "Run the setup wizard; it asks a few questions and creates a docs folder with a config file and sample pages.",
    "source": "$ npx vitepress init"
   },
   {
    "tab": "Step 3",
    "intro": "Start the local preview and edit the text files; changes show up at once.",
    "source": "$ npm run docs:dev"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "const vitepress = require('vitepress') in a project without \"type\": \"module\"",
   "fix": "Use import, add \"type\": \"module\" to package.json, or name the config .vitepress/config.mts",
   "why": "VitePress is published as ES modules only.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "Publishing to user.github.io/repo/ with the default base",
   "fix": "Set base: '/repo/' in the VitePress config",
   "why": "Without it, styles and links point to the domain root and the site looks broken.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "npm add -D vitepress@next copied from the docs into a project that needs a stable release",
   "fix": "npm add -D vitepress@1.6.4 (current latest), or pin the exact 2.0 alpha on purpose",
   "why": "The next tag points to a 2.0 alpha, while latest is 1.6.4.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Committing .vitepress/cache and .vitepress/dist to Git",
   "fix": "Add both folders to .gitignore and build on the host",
   "why": "They hold the dev server cache and the build output.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Using window or document at the top of a custom theme component",
   "fix": "Touch browser objects only in onMounted / mounted, or wrap the component in <ClientOnly>",
   "why": "Pages are pre-rendered in Node.js during the build, where the browser objects do not exist.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install vitepress",
  "repo": "https://github.com/vuejs/vitepress",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npx vitepress init (setup wizard); no account.",
  "formats": [
   "md",
   "vue"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": null,
  "rules_text": "- VitePress (Page and site templates). Vite + Vue static site generator with a default docs theme and a home/landing layout. Price: free; commercial use OK; no credit needed. Style: minimal.\n  Connect: npm vitepress.\n  Get files: npx vitepress init (setup wizard); no account (md, vue).\n  Not allowed: Needs Node.js\n  Rule: Keep the MIT copyright notice in the code if you redistribute it.\n  Rule: No visible credit on the site is required by the licence.\n  License: https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/vitepress/)",
  "agent_md": "https://agentgid.com/assets/vitepress/agent.md",
  "card_json": "https://agentgid.com/assets/vitepress/card.json"
 },
 "popularity": {
  "gid_score": 57,
  "stars": 18500,
  "downloads_7d": 1980108,
  "downloads_7d_label": "2M",
  "downloads_change_4w_pct": 35.3,
  "eco": "npm",
  "package": "vitepress",
  "repo": "vuejs/vitepress",
  "agent_projects": 20,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     393001
    ],
    [
     "2025-11-24",
     393150
    ],
    [
     "2025-12-01",
     397151
    ],
    [
     "2025-12-08",
     366391
    ],
    [
     "2025-12-15",
     366342
    ],
    [
     "2025-12-22",
     239715
    ],
    [
     "2025-12-29",
     224052
    ],
    [
     "2026-01-05",
     273862
    ],
    [
     "2026-01-12",
     373517
    ],
    [
     "2026-01-19",
     359605
    ],
    [
     "2026-01-26",
     365580
    ],
    [
     "2026-02-02",
     358575
    ],
    [
     "2026-02-09",
     383037
    ],
    [
     "2026-02-16",
     372594
    ],
    [
     "2026-02-23",
     384601
    ],
    [
     "2026-03-02",
     425301
    ],
    [
     "2026-03-09",
     444093
    ],
    [
     "2026-03-16",
     417987
    ],
    [
     "2026-03-23",
     389185
    ],
    [
     "2026-03-30",
     432266
    ],
    [
     "2026-04-06",
     442238
    ],
    [
     "2026-04-13",
     443933
    ],
    [
     "2026-04-20",
     449884
    ],
    [
     "2026-04-27",
     477664
    ],
    [
     "2026-05-04",
     495446
    ],
    [
     "2026-05-11",
     555008
    ],
    [
     "2026-05-18",
     547883
    ],
    [
     "2026-05-25",
     507415
    ],
    [
     "2026-06-01",
     554670
    ],
    [
     "2026-06-08",
     668245
    ],
    [
     "2026-06-15",
     855869
    ],
    [
     "2026-06-22",
     660041
    ],
    [
     "2026-06-29",
     601969
    ],
    [
     "2026-07-06",
     649962
    ],
    [
     "2026-07-13",
     699973
    ],
    [
     "2026-07-20",
     727191
    ],
    [
     "2026-07-27",
     728101
    ],
    [
     "2026-08-03",
     768104
    ],
    [
     "2026-08-10",
     999171
    ],
    [
     "2026-08-17",
     1022921
    ],
    [
     "2026-08-24",
     1073299
    ],
    [
     "2026-08-31",
     1136578
    ],
    [
     "2026-09-07",
     829394
    ],
    [
     "2026-09-14",
     1049457
    ],
    [
     "2026-09-21",
     1256262
    ],
    [
     "2026-09-28",
     1426479
    ],
    [
     "2026-10-05",
     1327372
    ],
    [
     "2026-10-12",
     1164238
    ],
    [
     "2026-10-19",
     1208348
    ],
    [
     "2026-10-26",
     1842549
    ],
    [
     "2026-11-02",
     1981967
    ],
    [
     "2026-11-09",
     1969605
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     18470
    ],
    [
     "2026-11-08",
     18471
    ],
    [
     "2026-11-09",
     18478
    ],
    [
     "2026-11-10",
     18481
    ],
    [
     "2026-11-11",
     18487
    ],
    [
     "2026-11-12",
     18488
    ],
    [
     "2026-11-13",
     18488
    ],
    [
     "2026-11-14",
     18492
    ],
    [
     "2026-11-15",
     18495
    ],
    [
     "2026-11-16",
     18494
    ],
    [
     "2026-11-17",
     18500
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-15"
 },
 "alternatives": [
  {
   "slug": "vitepress",
   "name": "VitePress",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "starlight",
   "name": "Starlight",
   "why": "Pick Starlight when your site is built with Astro and you want a docs template with navigation, search and translations.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "docusaurus",
   "name": "Docusaurus",
   "why": "Pick Docusaurus when you prefer React and want docs, a blog and a landing page in one classic template.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "nextra",
   "name": "Nextra",
   "why": "Pick Nextra when the rest of your project already runs on Next.js.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "bootstrap-examples",
   "name": "Bootstrap Examples",
   "why": "Official Bootstrap 5 example snippets and layouts: heroes, features, pricing, headers, footers, dashboards; one zip download.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "nuxt-ui",
   "name": "Nuxt UI",
   "why": "Vue/Nuxt UI library (125+ components, Reka UI + Tailwind) with page-level components and MIT starter templates: landing, SaaS, docs, dashboard.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Do I need to know how to code?",
   "a": "Not for writing pages; they are Markdown text files. Setting it up and publishing needs Node.js and a few terminal commands, which an AI assistant can run."
  },
  {
   "q": "Where can I host the site?",
   "a": "Anywhere that serves plain web pages; the docs have guides for Netlify, Vercel, Cloudflare Pages, GitHub Pages, GitLab Pages and others."
  },
  {
   "q": "Does it have search?",
   "a": "Yes. A local search that runs in the visitor's browser is built in, and Algolia DocSearch is supported."
  },
  {
   "q": "Can I use it for a commercial product's docs?",
   "a": "Yes. It is MIT licensed, and no credit on the site is required."
  },
  {
   "q": "Can I add interactive parts to a page?",
   "a": "Yes. Every Markdown page can also hold Vue components, so you can embed small interactive pieces."
  }
 ],
 "at_a_glance": {
  "latest_version": "1.6.4",
  "last_release": "2026-10-25",
  "last_commit": "2026-11-12",
  "runtime": "Node.js 18+ for 1.6.4 (stable, npm latest); the vitepress.dev docs describe 2.0.0-alpha (vitepress@next), which asks for Node.js 22+. ESM only.",
  "key_needed": false,
  "formats": "md, vue"
 },
 "good_to_know": [
  "You need Node.js on your computer or build server. The current docs ask for version 22 or newer.",
  "The website docs now describe the 2.0 test version, installed as vitepress@next. The newest stable release is 1.6.4, and its own guide asks for Node.js 18 or newer.",
  "Pages are made once when you build the site. Content that changes for each visitor needs a different tool or your own code.",
  "Search through Algolia needs keys from your own Algolia DocSearch setup; the built-in local search needs nothing."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-15",
  "sources": [
   {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev/"
   },
   {
    "label": "vitepress.dev/llms.txt",
    "url": "https://vitepress.dev/llms.txt"
   },
   {
    "label": "vitepress.dev/guide/what-is-vitepress.md",
    "url": "https://vitepress.dev/guide/what-is-vitepress.md"
   },
   {
    "label": "vitepress.dev/guide/getting-started.md",
    "url": "https://vitepress.dev/guide/getting-started.md"
   },
   {
    "label": "vitepress.dev/guide/deploy.md",
    "url": "https://vitepress.dev/guide/deploy.md"
   },
   {
    "label": "vitepress.dev/guide/i18n.md",
    "url": "https://vitepress.dev/guide/i18n.md"
   },
   {
    "label": "vitepress.dev/guide/routing.md",
    "url": "https://vitepress.dev/guide/routing.md"
   },
   {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev/guide/sitemap-generation.md"
   },
   {
    "label": "vitepress.dev/guide/ssr-compat.md",
    "url": "https://vitepress.dev/guide/ssr-compat.md"
   },
   {
    "label": "vitepress.dev/guide/using-vue.md",
    "url": "https://vitepress.dev/guide/using-vue.md"
   },
   {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev/reference/default-theme-home-page.md"
   },
   {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev/reference/default-theme-search.md"
   },
   {
    "label": "github.com/vuejs/vitepress",
    "url": "https://github.com/vuejs/vitepress"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/vuejs/vitepress/blob/main/LICENSE"
   },
   {
    "label": "github.com/vuejs/vitepress/blob/v1.6.4/docs/en/guide/getting-started.md",
    "url": "https://github.com/vuejs/vitepress/blob/v1.6.4/docs/en/guide/getting-started.md"
   },
   {
    "label": "npm: vitepress",
    "url": "https://registry.npmjs.org/vitepress"
   },
   {
    "label": "npm: vitepress/1.6.4",
    "url": "https://registry.npmjs.org/vitepress/1.6.4"
   },
   {
    "label": "vitepress.dev",
    "url": "https://vitepress.dev"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/vuejs/vitepress/main/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/vitepress/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
