\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.",[3156],{"name":3157,"color":3158},"bug: pending triage","e99695",4917,"Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.7572407,{"description":3165,"labels":3166,"number":3173,"owner":3146,"repository":3147,"state":3148,"title":3174,"updated_at":3175,"url":3176,"score":3177},"### Describe the bug\n\nas we create too deep folders , appear the fault : file name too long while build\n\n### Reproduction\n\ncreate too deep folders\n\n### Expected behavior\n\nexcept can build success, even zhe folders is deep and each folder name is long\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.16299\r\n CPU: (6) x64 Intel(R) Core(TM) i5-8500 CPU @ 3.00GHz\r\n Memory: 5.00 GB / 15.89 GB\r\n Binaries:\r\n Node: 20.9.0 - D:\\program\\nvm1.1.11\\nodejs\\node.EXE\r\n npm: 10.1.0 - D:\\program\\nvm1.1.11\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (41.16299.1480.0)\r\n Internet Explorer: 11.0.16299.371\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.44 => 1.0.1\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.",[3167,3170],{"name":3168,"color":3169},"build","377ba8",{"name":3171,"color":3172},"stale","ededed",3763,"file name too long ","2025-03-02T18:09:25Z","https://github.com/vuejs/vitepress/issues/3763",0.76223147,{"description":3179,"labels":3180,"number":3182,"owner":3146,"repository":3147,"state":3148,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### Is your feature request related to a problem? Please describe.\r\n\r\nsuch as a vue components library site……\r\nA common problem for a documentation page is to show how to use a component, both in code and with demo of live component.\r\n\r\n### Describe the solution you'd like\r\n\r\nlike this [https://github.com/flingyp/vitepress-demo-preview](https://github.com/flingyp/vitepress-demo-preview)\r\n\r\n### Describe alternatives you've considered\r\n\r\n_No response_\r\n\r\n### Additional context\r\n\r\n_No response_\r\n\r\n### Validations\r\n\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\r\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[3181],{"name":3171,"color":3172},3270,"Feature request: Vue component source code demo","2024-01-18T18:48:08Z","https://github.com/vuejs/vitepress/issues/3270",0.7624052,{"description":3188,"labels":3189,"number":3190,"owner":3146,"repository":3147,"state":3191,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### Describe the bug\n\nWhen an inline SVG includes `\u003Ca>`, the following error happens.\r\n\r\n```\r\nUncaught TypeError: Cannot read properties of undefined (reading 'match')\r\n at app.2726314c.js:7:46422\r\n at NodeList.forEach (\u003Canonymous>)\r\n at app.2726314c.js:7:46366\r\n```\r\nThe error seems to be happening on this line.\r\nhttps://github.com/vuejs/vitepress/blob/0048e2bf1e7ef0bf0a4b66bcdd49f9dc84074b2d/src/client/app/composables/preFetch.ts#L78\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-wmvpvc?file=docs%2Findex.md\n\n### Expected behavior\n\nNo error happens.\n\n### System Info\n\n```shell\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: 16.14.2 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 7.17.0 - /usr/local/bin/npm\r\n npmPackages:\r\n vitepress: latest => 1.0.0-alpha.40\n```\n\n\n### Additional context\n\nA real world reproduction: https://rollupjs.org/plugin-development/\r\n\r\nI guess this bug doesn't affect any functionality other than prefetching.\r\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.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[],1841,"closed","`Cannot read properties of undefined (reading 'match')` happens when an inline SVG includes `\u003Ca>`","2023-02-06T00:04:29Z","https://github.com/vuejs/vitepress/issues/1841",0.72976995,{"description":3197,"labels":3198,"number":3199,"owner":3146,"repository":3147,"state":3191,"title":3200,"updated_at":3201,"url":3202,"score":3203},"### Describe the bug\n\nSetting 'auto' to a sidebar property in config.js does not create automatic sidebar elements.\n\n### Reproduction\n\n```\r\n sidebar: {\r\n '/projects/': 'auto',\r\n }\r\n```\n\n### Expected behavior\n\n A sidebar should be auto generated using the headings provided in the markdown files for the projects page\n\n### System Info\n\n```Text\nvitepress version: 1.0.2\r\nvite version: 1.0.0\r\nNode version: v21.6.1\r\nOS version: Windows 11 Pro 23H2\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.",[],3755,"Automatic Headings in Sidebar","2024-04-28T12:24:54Z","https://github.com/vuejs/vitepress/issues/3755",0.7455507,{"description":3205,"labels":3206,"number":3208,"owner":3146,"repository":3147,"state":3191,"title":3209,"updated_at":3210,"url":3211,"score":3212},"### Describe the bug\r\n\r\nWhen you build the artifacts, logo images are missing.\r\n\r\n### Reproduction\r\n\r\nI followed [GitLab deploy guide](https://vitepress.vuejs.org/guide/deploying#gitlab-pages) then I read [PR 1451](https://github.com/vuejs/vitepress/pull/1451) and I configured default theme like this:\r\n\r\n```typescript\r\n outDir: '../public',\r\n base: '/group/repository/',\r\n themeConfig: {\r\n logo: {\r\n light: '/i/logo-light.png',\r\n dark: '/i/logo-dark.png',\r\n alt: 'My Alt Text',\r\n },\r\n },\r\n```\r\n\r\nFinally, I've created `docs/i/logo-light.png` and the dark one. \r\nWorks fine during development. Images get rendered, they are abt 14Kb\r\n\r\n### Expected behavior\r\n\r\nExpected to be fine also after build. But it's missing logo files. \r\nThere's only `ita.jpeg` who's embedded by using \r\n\r\n```bash\r\ntassoman@i2000014518:~/devel/GitLab/myrepo$(main) ls -alhR public/\r\npublic/:\r\ntotale 56K\r\ndrwxrwxr-x 3 tassoman tassoman 4,0K mar 3 18:25 .\r\ndrwxrwxr-x 6 tassoman tassoman 4,0K mar 3 18:25 ..\r\n-rw-rw-r-- 1 tassoman tassoman 9,7K mar 3 18:25 404.html\r\ndrwxrwxr-x 2 tassoman tassoman 4,0K mar 3 18:25 assets\r\n-rw-rw-r-- 1 tassoman tassoman 24 mar 3 18:25 hashmap.json\r\n-rw-rw-r-- 1 tassoman tassoman 27K mar 3 18:25 index.html\r\n\r\npublic/assets:\r\ntotale 716K\r\ndrwxrwxr-x 2 tassoman tassoman 4,0K mar 3 18:25 .\r\ndrwxrwxr-x 3 tassoman tassoman 4,0K mar 3 18:25 ..\r\n-rw-rw-r-- 1 tassoman tassoman 136K mar 3 18:25 app.9d50fb2d.js\r\n-rw-rw-r-- 1 tassoman tassoman 18K mar 3 18:25 index.md.2dde5316.js\r\n-rw-rw-r-- 1 tassoman tassoman 1,8K mar 3 18:25 index.md.2dde5316.lean.js\r\n-rw-rw-r-- 1 tassoman tassoman 18K mar 3 18:25 inter-italic-cyrillic.ea42a392.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 28K mar 3 18:25 inter-italic-cyrillic-ext.33bd5a8e.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 23K mar 3 18:25 inter-italic-greek.8f4463c4.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 12K mar 3 18:25 inter-italic-greek-ext.4fbe9427.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 45K mar 3 18:25 inter-italic-latin.bd3b6f56.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 63K mar 3 18:25 inter-italic-latin-ext.bd8920cc.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 8,6K mar 3 18:25 inter-italic-vietnamese.6ce511fb.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 17K mar 3 18:25 inter-roman-cyrillic.5f2c6c8c.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 26K mar 3 18:25 inter-roman-cyrillic-ext.e75737ce.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 22K mar 3 18:25 inter-roman-greek.d5a6d92a.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 12K mar 3 18:25 inter-roman-greek-ext.ab0619bc.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 42K mar 3 18:25 inter-roman-latin.2ed14f66.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 59K mar 3 18:25 inter-roman-latin-ext.0030eebd.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 8,3K mar 3 18:25 inter-roman-vietnamese.14ce25a6.woff2\r\n-rw-rw-r-- 1 tassoman tassoman 47K mar 3 18:25 ita.42a9fca8.jpeg \u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\u003C\r\n-rw-rw-r-- 1 tassoman tassoman 90K mar 3 18:25 style.4da33c5a.css\r\n\r\n```\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: Linux 5.15 Ubuntu 22.04.2 LTS 22.04.2 LTS (Jammy Jellyfish)\r\n CPU: (8) x64 Intel(R) Core(TM) i7-4702MQ CPU @ 2.20GHz\r\n Memory: 3.75 GB / 7.46 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 16.14.0 - ~/.nvm/versions/node/v16.14.0/bin/node\r\n Yarn: 1.22.19 - ~/.yarn/bin/yarn\r\n npm: 9.6.0 - ~/.nvm/versions/node/v16.14.0/bin/npm\r\n Browsers:\r\n Chromium: 110.0.5481.100\r\n Firefox: 110.0.1\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.49 => 1.0.0-alpha.49\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] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3207],{"name":3157,"color":3158},2031,"Missing assets logo light/dark after build","2023-03-11T00:04:09Z","https://github.com/vuejs/vitepress/issues/2031",0.7520118,{"description":3214,"labels":3215,"number":3219,"owner":3146,"repository":3147,"state":3191,"title":3220,"updated_at":3221,"url":3222,"score":3223},"### Describe the bug\n\nyarn docs:build\r\nassets path error in 「dist/index.html」\n\n### Reproduction\n\nyarn docs:build\n\n### Expected behavior\n\nassets path true in「dist/index.html」\n\n### System Info\n\n```shell\nnode v16.18.0\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3216],{"name":3217,"color":3218},"need more info","bdbefc",1999,"assets path error in 「dist/index.html」","2023-03-07T00:04:54Z","https://github.com/vuejs/vitepress/issues/1999",0.7586972,{"description":3225,"labels":3226,"number":3228,"owner":3146,"repository":3147,"state":3191,"title":3229,"updated_at":3230,"url":3231,"score":3232},"### 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.",[3227],{"name":3157,"color":3158},4856,"vitepress not work for flowbite-vue","2025-07-25T10:13:26Z","https://github.com/vuejs/vitepress/issues/4856",0.7595451,{"description":3234,"labels":3235,"number":3237,"owner":3146,"repository":3147,"state":3191,"title":3238,"updated_at":3239,"url":3240,"score":3241},"### Describe the bug\n\nBuild failed Due to relative path\r\n`RollupError: Could not resolve \"../../component/frame/jsonly/FrameJsonDB.vue\" from \"docs/fragment/graph/graphviz-base.md\"`\r\n\r\ndocs:dev : OK\r\n\n\n### Reproduction\n\nRepo to be created\n\n### Expected behavior\n\nBuild OK as Dev OK\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22000\r\n CPU: (8) x64 Intel(R) Core(TM) i7-6700HQ CPU @ 2.60GHz\r\n Memory: 4.91 GB / 15.88 GB\r\n Binaries:\r\n Node: 18.15.0 - D:\\Tools\\Nodejs\\18.15.0\\node.EXE\r\n npm: 9.8.1 - D:\\Tools\\Nodejs\\18.15.0\\npm.CMD\r\n pnpm: 8.6.3 - D:\\Tools\\Nodejs\\18.15.0\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22000.120.0), Chromium (119.0.2151.72)\r\n Internet Explorer: 11.0.22000.120\r\n npmPackages:\r\n vitepress: v1.0.0-rc.29 => 1.0.0-rc.29\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.",[3236],{"name":3217,"color":3218},3249,"Custom vue component Relative path import : \"build.command\" failed but docs:dev ok","2023-12-10T00:04:57Z","https://github.com/vuejs/vitepress/issues/3249",0.7612937,["Reactive",3243],{},["Set"],["ShallowReactive",3246],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fcPWxePUWjZZ9QqtbkLTRSHufOF-DsqGorIsFM5ltJFI":-1},"/vuejs/vitepress/3586"]