\n\n### Expected behavior\n\nI hope to use SVG and other methods instead of using masks to display icons, which can avoid frequent redrawing\n\n### System Info\n\n```Text\n\"vitepress\": \"^1.6.4\",\n```\n\n### Additional context\n\n\u003Cimg width=\"2559\" height=\"1042\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/39db5990-f3ee-47bb-8bcf-49272a1918f4\" />\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3145],{"name":3146,"color":3147},"bug: pending triage","e99695",4917,"vuejs","vitepress","open","Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.6827553,{"description":3157,"labels":3158,"number":3160,"owner":3149,"repository":3150,"state":3161,"title":3162,"updated_at":3163,"url":3164,"score":3165},"### Describe the bug\n\nCheck VP types here https://arethetypeswrong.github.io/?p=vitepress%401.0.0-beta.1, `vitepress/theme-without-fonts` types for node missing.\r\n\n\n### Reproduction\n\nhttps://arethetypeswrong.github.io/?p=vitepress%401.0.0-beta.1\n\n### Expected behavior\n\nTypes should be there\n\n### System Info\n\n```sh\nNA\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3159],{"name":3146,"color":3147},2415,"closed","missing vitepress/theme-without-fonts types for node","2023-06-02T00:04:15Z","https://github.com/vuejs/vitepress/issues/2415",0.6751119,{"description":3167,"labels":3168,"number":3173,"owner":3149,"repository":3150,"state":3161,"title":3174,"updated_at":3175,"url":3176,"score":3177},"### Describe the bug\n\n### dependencies\r\n\r\n`pnpm add @chenwei02/qy-element`\r\n> `@chenwei02/qy-element` has svg-icon component. svg files builded by vite-plugin-svg-icons.\r\n\r\n### docs\r\n`vitepress dev docs` is ok\r\n`vitepress build docs` then deploy to gh-pages, *.svg icon was blank.\r\n\r\n### Problem\r\nvitepress build docs . something is wrong.\r\n\r\n### Help\r\nI need help\n\n### Reproduction\n\npnpm add @chenwei02/qy-element\r\n\r\n*.md\r\n\u003Cqy-icon name=\"close\">\r\n\r\nvitepress build docs.\n\n### Expected behavior\n\nevery thing is ok.\n\n### System Info\n\n```sh\nvitepress : 1.0.0-alpha.64\r\n@chenwei02/qy-element: 1.0.2-p1\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3169,3170],{"name":3146,"color":3147},{"name":3171,"color":3172},"stale","ededed",2385,"Vitepress build Problem","2023-08-18T00:04:08Z","https://github.com/vuejs/vitepress/issues/2385",0.67807955,{"description":3179,"labels":3180,"number":3182,"owner":3149,"repository":3150,"state":3161,"title":3183,"updated_at":3184,"url":3185,"score":3186},"**Describe the bug**\r\n\r\nWhen using vitepress with vue v3.1, we are now running into a compilation error as some vitepress components are using `\u003Ctemplate functional>`\r\n\r\nThe related change in vue-next is https://github.com/vuejs/vue-next/commit/467076361a730b7925c88c572793c78637e05ca7\r\n\r\n**To Reproduce**\r\n\r\nSee [this PR in VTU](https://github.com/vuejs/vue-test-utils-next/pull/654) (that uses vitepress for the docs) that fails because of vitepress and vue 3.1 \r\n\r\nIt can easily be reproduced in the current codebase by bumping vue to v3.1 and run `yarn docs-build`:\r\n\r\n```\r\nSyntaxError: \u003Ctemplate functional> is no longer supported in Vue 3, since functional components no longer have significant performance difference from stateful ones. Just use a normal \u003Ctemplate> instead.\r\n at /Users/ced-pro/Code/vue/vitepress/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:196:37\r\n at Array.forEach (\u003Canonymous>)\r\n at parse (/Users/ced-pro/Code/vue/vitepress/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:182:18)\r\n at createDescriptor (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4048:62)\r\n at transformMain (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4344:32)\r\n at Object.transform (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4665:16)\r\n at /Users/ced-pro/Code/vue/vitepress/node_modules/rollup/dist/shared/rollup.js:19875:25 {\r\n loc: {\r\n start: { column: 11, line: 1, offset: 10 },\r\n end: { column: 21, line: 1, offset: 20 },\r\n source: 'functional'\r\n },\r\n id: '/Users/ced-pro/Code/vue/vitepress/dist/client/theme-default/com\r\n```\r\n\r\n**Expected behavior**\r\nvitepress should properly compile with Vue v3.1\r\n\r\n**System Info**\r\n- vitepress version: 0.14\r\n- vite version: 2.3.4\r\n- Node version: 14.17\r\n- OS version: macOS\r\n",[3181],{"name":3146,"color":3147},311,"Functional templates errors with vue v3.1","2023-01-21T16:22:22Z","https://github.com/vuejs/vitepress/issues/311",0.68159604,{"description":3188,"labels":3189,"number":3191,"owner":3149,"repository":3150,"state":3161,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### Describe the bug\n\nI added team component feedback error in index.md\r\n\r\n\n\n### Reproduction\n\n---\r\nlayout: home\r\n\r\nhero:\r\n name: VitePress\r\n text: Vite & Vue powered static site generator.\r\n tagline: Simple, powerful, and performant. Meet the modern SSG framework you've always wanted.\r\n actions:\r\n - theme: brand\r\n text: Get Started\r\n link: /example\r\n - theme: alt\r\n text: View on GitHub\r\n link: https://github.com/vuejs/vitepress\r\n---\r\n\r\n\u003Cscript setup>\r\nimport { VPTeamMembers } from 'vitepress/theme'\r\n\r\nconst members = [\r\n {\r\n avatar: 'https://www.github.com/yyx990803.png',\r\n name: 'Evan You',\r\n title: 'Creator',\r\n links: [\r\n { icon: 'github', link: 'https://github.com/yyx990803' },\r\n { icon: 'twitter', link: 'https://twitter.com/youyuxi' }\r\n ]\r\n },\r\n ...\r\n]\r\n\u003C/script>\r\n\r\n# Our Team\r\n\r\nSay hello to our awesome team.\r\n\r\n\u003CVPTeamMembers size=\"small\" :members=\"members\" />\r\n\n\n### Expected behavior\n\nnormal\n\n### System Info\n\n```Text\nSystem:\r\n OS: Linux 5.0 undefined\r\n CPU: (8) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 0 Bytes / 0 Bytes\r\n Shell: 1.0 - /bin/jsh\r\n Binaries:\r\n Node: 18.20.3 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 10.2.3 - /usr/local/bin/npm\r\n pnpm: 8.15.6 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: latest => 1.3.4\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3190],{"name":3146,"color":3147},4238,"Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.68262297,{"description":3197,"labels":3198,"number":3200,"owner":3149,"repository":3150,"state":3161,"title":3201,"updated_at":3202,"url":3203,"score":3204},"### Describe the bug\n\nhttps://flowbite-vue.com/pages/getting-started\n\n\u003Cimg width=\"97\" height=\"103\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/eb9f85c1-6df8-47e9-950a-8b1aeb92b7ba\" />\n\n\n```vue\n\u003Cscript setup>\nimport { FwbButton } from 'flowbite-vue'\n\u003C/script>\n\u003Ctemplate>\n \u003Cdiv>\n \u003Cfwb-button color=\"default\">Default\u003C/fwb-button>\n \u003C/div>\n\u003C/template>\n```\n\n### Reproduction\n\nhttps://github.com/jk2K/testvitepress\n\ntech stack\n1. https://flowbite-vue.com/pages/getting-started\n2. tailwindcss v4\n\n### Expected behavior\n\n\u003Cimg width=\"103\" height=\"50\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7bffdf53-2faf-4257-87c2-4f60511b7060\" />\n\n### System Info\n\n```Text\nSystem:\n OS: macOS 15.5\n CPU: (14) arm64 Apple M4 Pro\n Memory: 218.33 MB / 48.00 GB\n Shell: 5.9 - /bin/zsh\n Binaries:\n Node: 22.16.0 - ~/.nvm/versions/node/v22.16.0/bin/node\n npm: 10.9.2 - ~/.nvm/versions/node/v22.16.0/bin/npm\n pnpm: 10.11.0 - /opt/homebrew/bin/pnpm\n Browsers:\n Chrome: 138.0.7204.159\n Safari: 18.5\n npmPackages:\n vitepress: ^1.6.3 => 1.6.3\n```\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3199],{"name":3146,"color":3147},4856,"vitepress not work for flowbite-vue","2025-07-25T10:13:26Z","https://github.com/vuejs/vitepress/issues/4856",0.6879627,{"description":3206,"labels":3207,"number":3211,"owner":3149,"repository":3150,"state":3161,"title":3212,"updated_at":3213,"url":3214,"score":3215},"### Is your feature request related to a problem? Please describe.\n\nI recently upgraded my project to use Vite `v6`. However, I encountered type conflicts between VitePress and my project due to VitePress using Vite `v5`. The error message is as follows:\n\n```bash\nType 'import(\"/code/node_modules/vite/dist/node/index\").PluginOption' is not assignable to type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").PluginOption'.\n Type 'Plugin\u003Cany>' is not assignable to type 'PluginOption'.\n Type 'import(\"/code/node_modules/vite/dist/node/index\").Plugin\u003Cany>' is not assignable to type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").Plugin\u003Cany>'.\n Types of property 'apply' are incompatible.\n Type '\"serve\" | \"build\" | ((this: void, config: import(\"/code/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vite/dist/node/index\").ConfigEnv) => boolean) | undefined' is not assignable to type '\"serve\" | \"build\" | ((this: void, config: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").ConfigEnv) => boolean) | undefined'.\n Type '(this: void, config: UserConfig, env: ConfigEnv) => boolean' is not assignable to type '\"serve\" | \"build\" | ((this: void, config: UserConfig, env: ConfigEnv) => boolean) | undefined'.\n Type '(this: void, config: import(\"/code/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vite/dist/node/index\").ConfigEnv) => boolean' is not assignable to type '(this: void, config: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").ConfigEnv) => boolean'.\n Types of parameters 'config' and 'config' are incompatible.\n Type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").UserConfig' is not assignable to type 'import(\"/code/node_modules/vite/dist/node/index\").UserConfig'.\n Types of property 'plugins' are incompatible.\n Type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").PluginOption[] | undefined' is not assignable to type 'import(\"/code/node_modules/vite/dist/node/index\").PluginOption[] | undefined'.\n Type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").PluginOption[]' is not assignable to type 'import(\"/code/node_modules/vite/dist/node/index\").PluginOption[]'.\n Type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").PluginOption' is not assignable to type 'import(\"/code/node_modules/vite/dist/node/index\").PluginOption'.\n Type 'Plugin\u003Cany>' is not assignable to type 'PluginOption'.\n Type 'import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").Plugin\u003Cany>' is not assignable to type 'import(\"/code/node_modules/vite/dist/node/index\").Plugin\u003Cany>'.\n Types of property 'apply' are incompatible.\n Type '\"serve\" | \"build\" | ((this: void, config: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vitepress/node_modules/vite/dist/node/index\").ConfigEnv) => boolean) | undefined' is not assignable to type '\"serve\" | \"build\" | ((this: void, config: import(\"/code/node_modules/vite/dist/node/index\").UserConfig, env: import(\"/code/node_modules/vite/dist/node/index\").ConfigEnv) => boolean) | undefined'.\n Type '(this: void, config: UserConfig, env: ConfigEnv) => boolean' is not assignable to type '\"serve\" | \"build\" | ((this: void, config: UserConfig, env: ConfigEnv) => boolean)\n```\n\n### Describe the solution you'd like\n\nTo resolve this, could you please upgrade VitePress to use Vite `v6`? This will help avoid type conflicts and ensure compatibility with projects using the latest version of Vite.\n\n### Describe alternatives you've considered\n\n_No response_\n\n### Additional context\n\nThe plugins causing this issue are [`vite-plugin-vue-devtools`](https://www.npmjs.com/package/vite-plugin-vue-devtools) and [`vite-plugin-vuetify`](https://www.npmjs.com/package/vite-plugin-vuetify). These plugins are used in the Vite configuration within VitePress:\n\n```ts\nexport default defineConfig({\n ...\n vite: {\n ...\n plugins: [\n vueDevTools(),\n vuetify({\n autoImport: true,\n styles: { configFile: \"../../src/styles/settings.scss\" }\n })\n ],\n ...\n})\n```\n\n### Validations\n\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [x] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[3208],{"name":3209,"color":3210},"build","377ba8",4494,"Upgrade VitePress to use Vite `v6`","2025-01-30T04:43:08Z","https://github.com/vuejs/vitepress/issues/4494",0.69545895,{"description":3217,"labels":3218,"number":3220,"owner":3149,"repository":3150,"state":3161,"title":3221,"updated_at":3222,"url":3223,"score":3224},"\u003C!--\r\nNOTE:\r\nVitePress is still WIP, and it is not compatible with VuePress.\r\nPlease do not open issue about default theme missing features or something doesn't work like VuePress.\r\n-->\r\n\r\n**Describe the bug**\r\nAfter running npx vitepress, I open the browser and load the address of http://localhost:3000, but I get a error.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\nPS D:\\桌面\\demo> npx vitepress\r\nvitepress v0.5.0\r\nvite v1.0.0-rc.4\r\nlistening at http://localhost:3000\r\n[vite] Failed to resolve module import \"vue/dist/vue.runtime.esm-bundler.js.0.0-rc.5@vuedist\u000bue.runtime.esm-bundler.js\". (imported by /@app/components/Debug.vue)\r\n\r\n**Expected behavior**\r\nGetting \"Hello Vitepress\" in browser.\r\n\r\n**System Info**\r\n- vitepress version: v0.5.0\r\n- vite version: v1.0.0-rc.4\r\n- Node version: 12.14.0\r\n- OS version:10.0.19041 暂缺 Build 19041\r\n\r\n**Additional context**\r\n尤大大,I am you big fan.\r\n",[3219],{"name":3146,"color":3147},65,"服务启动之后,进入地址报错","2023-01-21T16:25:36Z","https://github.com/vuejs/vitepress/issues/65",0.69679517,{"description":3226,"labels":3227,"number":3229,"owner":3149,"repository":3150,"state":3161,"title":3230,"updated_at":3231,"url":3232,"score":3233},"### Describe the bug\n\nI want to use the vue component in vitepress. I have read the documentation on the official website, but when I do it, I encounter an error like this.\r\n```bash\r\n[plugin:vite:vue] Tags with side effect (\u003Cscript> and \u003Cstyle>) are ignored in client component templates.\r\n```\r\n\r\nI don't understand what I'm encountering, I just want to achieve the effect here in this vue document\r\n\r\n> https://cn.vuejs.org/guide/reusability/composables.html#vs-react-hooks\r\n\r\n\r\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-dn63jg?file=docs%2Fhooks%2FuseMouse.js,docs%2Fexample.md\n\n### Expected behavior\n\nThe documentation on the official website makes me understand the difficulty or the need for a better demo?\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (20) x64 13th Gen Intel(R) CoreT i7-13800H\r\n Memory: 17.07 GB / 31.74 GB\r\n Binaries:\r\n Node: 20.11.0 - ~\\AppData\\Local\\pnpm\\node.EXE\r\n npm: 10.2.4 - ~\\AppData\\Local\\pnpm\\npm.CMD\r\n pnpm: 8.14.1 - ~\\AppData\\Local\\pnpm\\pnpm.EXE\r\n Browsers:\r\n Edge: Chromium (120.0.2210.133)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: 1.0.0-rc.39 => 1.0.0-rc.39\n```\n\n\n### Additional context\n\nPlease tell me the correct way to write it, thank you\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3228],{"name":3146,"color":3147},3485,"Using vue to report errors in markdown","2024-01-29T00:04:28Z","https://github.com/vuejs/vitepress/issues/3485",0.69748145,{"description":3235,"labels":3236,"number":3238,"owner":3149,"repository":3150,"state":3161,"title":3239,"updated_at":3240,"url":3241,"score":3242},"### Describe the bug\r\n\r\n\r\n`config.ts`\r\n```ts\r\nexport default defineConfig({\r\n vite: {\r\n css: {\r\n postcss: {\r\n plugins: [\r\n postcssIsolateStyles({\r\n includeFiles: [/vp-doc\\.css/]\r\n }),\r\n ],\r\n },\r\n }\r\n})\r\n```\r\n\r\n### Reproduction\r\n\r\nSee above\r\n\r\n### Expected behavior\r\n\r\nNo error\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz\r\n Memory: 38.35 GB / 63.84 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\NodeJS\\node.EXE\r\n Yarn: 1.22.19 - C:\\NodeJS\\yarn.CMD\r\n npm: 9.8.1 - C:\\NodeJS\\npm.CMD\r\n pnpm: 8.7.0 - C:\\NodeJS\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (116.0.1938.62)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.9 => 1.0.0-rc.9\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n_No response_\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3237],{"name":3146,"color":3147},2867,"`postcssIsolateStyles` type issue with inline postcss plugin config in `vite` configs","2023-09-05T00:04:09Z","https://github.com/vuejs/vitepress/issues/2867",0.6975295,["Reactive",3244],{},["Set"],["ShallowReactive",3247],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fOKYiGx-X2P-w_6BzKqeYsJMnOWdKas-fO7Qh63QxiFM":-1},"/vuejs/vitepress/2968"]