\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.",[3151],{"name":3152,"color":3153},"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.71818274,{"description":3163,"labels":3164,"number":3168,"owner":3155,"repository":3156,"state":3169,"title":3170,"updated_at":3171,"url":3172,"score":3173},"### Describe the bug\n\nBy default, `--vp-layout-max-width` is equal to 1440px. The same value is used in the media queries. If the `--vp-layout-max-width` is bigger than 1440px, then the layout breaks when the window width is less than the new `--vp-layout-max-width`, but bigger than 1440px. \n\n### Reproduction\n\nTo reproduce from scratch:\r\n\r\n1. Create a new vitepress project. Choose the \"Default Theme + Customization\" option.\r\n2. Add\r\n ```css\r\n :root {\r\n --vp-layout-max-width: 1800px;\r\n }\r\n ```\r\n to the `style.css` file. \r\n3. Run in dev, open the `markdown-examples.html` page and make the window width equal to 1550px.\r\n\r\nAlternatively, you can clone this repo https://github.com/deenns/vitepress-bugs, run the dev script, open `markdown-examples.html` page and make the window width equal to 1550px. You will see the following: \r\n\r\n\r\n\r\nThe sidebar width is less than needed.\r\n\n\n### Expected behavior\n\nThe sidebar width should not be less than required. \n\n### System Info\n\n```sh\n\"vitepress\": \"^1.0.0-beta.2\"\r\n```\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.",[3165],{"name":3166,"color":3167},"stale","ededed",2505,"closed","--vp-layout-max-width bigger than 1440px breaks layout","2024-01-11T00:04:44Z","https://github.com/vuejs/vitepress/issues/2505",0.6784697,{"description":3175,"labels":3176,"number":3181,"owner":3155,"repository":3156,"state":3169,"title":3182,"updated_at":3183,"url":3184,"score":3185},"### Describe the bug\n\nHello, when I was searching using Algolia, the search results on the vitepress page were not displayed. However, Algolia's console page showed 140 records. Is this a missing configuration? By the way, for the project reason, I didn't use docsearch, but Algolia's build plan\n\n### Reproduction\n\nThe error can be seen on this website https://stackblitz.com/edit/vite-48o9dv?file=docs%2F.vitepress%2Fconfig.ts,package.json\r\nThis is the source code of the website https://github.com/galgaxy3/docs-demo\n\n### Expected behavior\n\nThere should be a query result\n\n### System Info\n\n```Text\nChrome, vitepress 1.0.0-rc.44\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.",[3177,3180],{"name":3178,"color":3179},"question","5D5FAE",{"name":3166,"color":3167},3614,"Algolia search result is empty","2024-04-28T12:24:52Z","https://github.com/vuejs/vitepress/issues/3614",0.68008834,{"description":3187,"labels":3188,"number":3190,"owner":3155,"repository":3156,"state":3169,"title":3191,"updated_at":3192,"url":3193,"score":3194},"The Algolia search component no longer seems to return any results; this includes the VitePress docs themselves:\r\n\r\nhttps://vitepress.vuejs.org/\r\n\r\nI suspect something might be going wrong in terms of passing the API key / index name down to the Algolia DocSearch component.",[3189],{"name":3152,"color":3153},316,"Algolia search no longer seems to be working","2023-01-21T16:22:20Z","https://github.com/vuejs/vitepress/issues/316",0.6892663,{"description":3196,"labels":3197,"number":3201,"owner":3155,"repository":3156,"state":3169,"title":3202,"updated_at":3203,"url":3204,"score":3205},"### Describe the bug\n\nEven when you set theme.outline = false vitepress still adds class has-aside and therefore content is unnecessary constrained to narrow space\n\n### Reproduction\n\nSet theme.outline to false to hide aside. Even thou it's not displayed it still ocupies space and therefore width of .VPDoc container is the same as with theme.outline\n\n### Expected behavior\n\nWhen aside is hidden it should free up space\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (12) x64 Intel(R) Core(TM) i7-8700 CPU @ 3.20GHz\r\n Memory: 5.57 GB / 15.80 GB\r\n Binaries:\r\n Node: 16.16.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.11 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 9.2.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (109.0.1518.78)\r\n Internet Explorer: 11.0.19041.1566\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.",[3198],{"name":3199,"color":3200},"theme","0754FB",1915,"support disabling aside in themeConfig","2023-02-20T00:04:34Z","https://github.com/vuejs/vitepress/issues/1915",0.6944574,{"description":3207,"labels":3208,"number":3209,"owner":3155,"repository":3156,"state":3169,"title":3210,"updated_at":3211,"url":3212,"score":3213},"### Describe the bug\r\n\r\nI am experiencing an issue with the integrated search component (Algolia).\r\nThe search function is not working properly, as it returns **zero results** when I use the web interface in my recently created project with Vitepress. \r\n\r\nHowever, if I perform a search using the API or on Algolia's website, the search function works correctly and returns results.\r\n\r\nIt's possible that there may be an issue with the search component in Vitepress that's causing this problem. \r\n\r\nI wanted to bring this to your attention in the hopes that it can be addressed and fixed as soon as possible. \r\n\r\n### Reproduction\r\n\r\n- Create an Algolia account\r\n- Configure the algolia section with index, API key and app id.\r\n - ```\r\n appId: '5D6FRGxxxx', \r\n apiKey: 'e04451b589c484090xxxxxxxxxxxxxxx', \r\n indexName: 'csspills'\r\n ```\r\n- Create the index (both manually / via API)\r\n - ```\r\n [\r\n {\r\n title: 'Pill 1 CLI',\r\n description: 'Create a new project with the CLI',\r\n tags: [ 'demo1', 'cli' ]\r\n },\r\n {\r\n title: 'Pill 2 AWS',\r\n description: 'Create a new AWS project from the command line',\r\n tags: [ 'demo2', 'AWS' ]\r\n }\r\n ]\r\n ```\r\n- Start the local server\r\n- Search \r\n\r\n\r\n\r\n\r\n### Expected behavior\r\n\r\nShow results after searching\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.2.1\r\n CPU: (8) x64 Apple M1\r\n Memory: 7.73 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.13.2 - ~/.nvm/versions/node/v16.13.2/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 8.1.2 - ~/.nvm/versions/node/v16.13.2/bin/npm\r\n Browsers:\r\n Brave Browser: 107.1.45.133\r\n Chrome: 109.0.5414.119\r\n Chrome Canary: 112.0.5609.0\r\n Firefox: 95.0.2\r\n Firefox Developer Edition: 108.0\r\n Safari: 16.3\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nUI Request: \r\n```\r\nhttps://5d6frgc6t9-dsn.algolia.net/1/indexes/*/queries?x-algolia-agent=Algolia%20for%20JavaScript%20(4.8.5)%3B%20Browser%20(lite)%3B%20docsearch%20(3.3.3)%3B%20docsearch-react%20(3.3.3)%3B%20docsearch.js%20(3.3.3)&x-algolia-api-key=e04451b589c484090xxxxxxxxxxxxxxx&x-algolia-application-id=5D6FRGxxxx\r\n```\r\nRequest Method: `POST`\r\nStatus Code: `200 OK`\r\n\r\n\r\n\r\nAPI Request (Node.js)\r\n\r\n\r\n```\r\n{\r\n hits: [\r\n {\r\n title: 'Pill 2 AWS',\r\n description: 'Create a new AWS project from the command line',\r\n tags: [Array],\r\n objectID: '85344354000',\r\n _highlightResult: [Object]\r\n }\r\n ],\r\n nbHits: 1,\r\n page: 0,\r\n nbPages: 1,\r\n hitsPerPage: 20,\r\n exhaustiveNbHits: true,\r\n exhaustiveTypo: true,\r\n exhaustive: { nbHits: true, typo: true },\r\n query: 'AWS',\r\n params: 'query=AWS',\r\n renderingContent: {},\r\n processingTimeMS: 1,\r\n processingTimingsMS: {\r\n getIdx: { load: [Object], total: 1 },\r\n request: { roundTrip: 30 },\r\n total: 1\r\n },\r\n serverTimeMS: 1\r\n}\r\n```\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.",[],1970,"Algolia search is broken","2023-03-03T12:16:55Z","https://github.com/vuejs/vitepress/issues/1970",0.69452494,{"description":3215,"labels":3216,"number":3220,"owner":3155,"repository":3156,"state":3169,"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\nThe theme is set as follows\r\n\r\n``` js\r\n{\r\n ...,\r\n title: 'Vite vui',\r\n base: '/vite-vui-docs/',\r\n themeConfig: {\r\n repo: 'bhabgs/vite-vui',\r\n search: true, // here\r\n sidebar: {\r\n '/': [\r\n {\r\n text: 'vui',\r\n children: [\r\n { text: '介绍', link: '/' },\r\n { text: '日志', link: '/components/log' },\r\n { text: 'Button', link: '/components/button/' },\r\n { text: 'Layout', link: '/components/layout/' },\r\n { text: 'contextmenu', link: '/components/contextmenu/' },\r\n ],\r\n },\r\n {\r\n text: 'vuu',\r\n children: [\r\n { text: '介绍', link: '/vuu/' },\r\n { text: '日志', link: '/vuu/log' },\r\n { text: '某个功能', link: '/vuu/any' },\r\n ],\r\n },\r\n ],\r\n },\r\n author: 'bhabgs',\r\n nav: [\r\n { text: '首页', link: '/' },\r\n { text: '分类', link: '/tags' },\r\n ],\r\n },\r\n dest: 'public',\r\n}\r\n```\r\n\r\n**To Reproduce**\r\n[to view](https://github.com/bhabgs/vite-vui/tree/master/docs)\r\n\r\n\r\n**Expected behavior**\r\nshow search box.\r\n\r\n\r\n\r\n**System Info**\r\n- vitepress version: 0。12.2\r\n- vite version: 2.0.3\r\n- Node version: 14*\r\n- OS version: 11.2.2\r\n\r\n\r\n",[3217],{"name":3218,"color":3219},"invalid","ffffff",272,"Invalid search for topic Settings !!!","2023-01-21T16:04:09Z","https://github.com/vuejs/vitepress/issues/272",0.6948128,{"description":3226,"labels":3227,"number":3228,"owner":3155,"repository":3156,"state":3169,"title":3229,"updated_at":3230,"url":3231,"score":3232},"### What problem does this feature solve?\r\nIt is actually a layout problem of `vue-router-next` documentation. Please accept my apology if I reported it in the wrong place.\r\n\r\nCurrently, the [official documentation site] layout is not worked as expected when it comes to the screen size with `959px` and `719px` breakpoints. \r\n\r\nUnexpected behaviours with breakpoints:\r\n- `959px`: `16.4rem` is applied to `margin-left` in the main section.\r\n- `719px`: `var(--sidebar-width)` is applied to `padding-left` in the main section.\r\n\r\nAs a result, the main content is hard to read when readers are using small-size screens, such as mobile phones, as the unexpected extra spaces are occupied.\r\n\r\n[official documentation site]: https://next.router.vuejs.org/guide/#html\r\n\r\n### What does the proposed API look like?\r\nI haven't used 'vitepress' before so I don't know if it is actually an issue of vitepress. But I have a 'temporary' solution for this issue:\r\n\r\nIn `/docs/.vitepress/theme/Layout.vue`:\r\n\r\n```vue\r\n\u003Cstyle>\r\n...\r\n\r\n/* Fix: Unexpected margin at 959px breakpoint */\r\n@media screen and (max-width: 959px) {\r\n .theme main {\r\n margin-left: 0;\r\n }\r\n}\r\n\r\n/* Fix: Unexpected padding at 719px breakpoint */\r\n@media screen and (max-width: 719px) {\r\n .theme main {\r\n padding-left: 0;\r\n }\r\n}\r\n\u003C/style>\r\n```\r\n\r\nAnd it should fix the layout problem existed.\r\n\r\nI believe that small changes can bring a big positive effect on the community. Thank you for reviewing this issue.\r\n\r\n\u003C!-- generated by vue-issues. DO NOT REMOVE -->",[],121,"Better Docs Layout for Small Screen","2023-01-21T16:24:17Z","https://github.com/vuejs/vitepress/issues/121",0.70860994,{"description":3234,"labels":3235,"number":3236,"owner":3155,"repository":3156,"state":3169,"title":3237,"updated_at":3238,"url":3239,"score":3240},"### Describe the bug\n\nCommit e544b411d91eba54154243b0af4cea3226c192c4 was merged into `main` and released as part of RC12. \r\n\r\n[The PR](https://github.com/vuejs/vitepress/pull/2933) states that the search dialogue shouldn't be closed under a number of circumstances one of which is when the user presses enter. \r\n\r\nNo justification is given for this or any description of what the intended behaviour should be. This is made even more confusing given the current UI explicitly states that Enter will select the item:\r\n\r\n\r\n\n\n### Reproduction\n\nAdd the following Markdown files to a Vitepress site:\r\n\r\n```markdown\r\n# Overview\r\n\r\nSome text ...\r\n```\r\n\r\n* Hit `Ctrl + K` and type \"Overview\".\r\n* Hit enter.\n\n### Expected behavior\n\nWhen a user hits Enter the search dialogue should be dismissed and Vitepress should navigate to the selected entry.\n\n### System Info\n\n```Text\nSystem:\r\n OS: Linux 6.2 Ubuntu 23.04 23.04 (Lunar Lobster)\r\n CPU: (16) x64 Intel(R) Core(TM) i9-10885H CPU @ 2.40GHz\r\n Memory: 56.57 GB / 62.54 GB\r\n Container: Yes\r\n Shell: 5.2.15 - /bin/bash\r\n Binaries:\r\n Node: 18.17.1 - /usr/bin/node\r\n npm: 9.6.7 - /usr/bin/npm\r\n pnpm: 8.6.12 - ~/.local/share/pnpm/pnpm\r\n Browsers:\r\n Chrome: 116.0.5845.179\r\n Chromium: 116.0.5845.179\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.12 => 1.0.0-rc.12\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.",[],2935,"Enter key no longer selects result in local search","2023-09-21T00:04:15Z","https://github.com/vuejs/vitepress/issues/2935",0.71317035,{"description":3242,"labels":3243,"number":3245,"owner":3155,"repository":3156,"state":3169,"title":3246,"updated_at":3247,"url":3248,"score":3249},"### Describe the bug\n\n1. 组件中 style scoped 使用了 bootstrap,某些 class 样式出不来,比如下面 `rounded`;\r\n\r\n\r\n2. 如果在 vue 组件的 script 导入 bootstrap,则会影响默认主题的样式,比如下面标题\r\n\r\n\r\n3. 不管是使用 slots 还是使用全局注册组件,都是一样的问题;\n\n### Reproduction\n\n默认主题结合 bootstrap 很容易重现。\n\n### Expected behavior\n\n我希望在 vitepress 的组件中使用 bootstrap 快速开发。\n\n### System Info\n\n```sh\nSystem:\r\n OS: Linux 5.15 Ubuntu 22.04.1 LTS 22.04.1 LTS (Jammy Jellyfish)\r\n CPU: (8) x64 Intel(R) Core(TM) i7-8650U CPU @ 1.90GHz\r\n Memory: 4.30 GB / 7.72 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 19.5.0 - ~/.nvm/versions/node/v19.5.0/bin/node\r\n npm: 9.6.4 - ~/.nvm/versions/node/v19.5.0/bin/npm\r\n pnpm: 8.6.9 - ~/.local/share/pnpm/pnpm\r\n npmPackages:\r\n vitepress: 1.0.0-beta.6 => 1.0.0-beta.6\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.",[3244],{"name":3199,"color":3200},2683,"默认主题添加组件使用 bootstrap 样式没有预期","2023-08-18T00:04:15Z","https://github.com/vuejs/vitepress/issues/2683",0.7162279,["Reactive",3251],{},["Set"],["ShallowReactive",3254],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fuX5NG-byik0a0-N_q66IYQnOGl6Yux001A-3sciJb50":-1},"/vuejs/vitepress/250"]