\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.7335492,{"description":3163,"labels":3164,"number":3174,"owner":3155,"repository":3156,"state":3157,"title":3175,"updated_at":3176,"url":3177,"score":3178},"### Describe the bug\r\n\r\nUsage:\r\n```yaml\r\nfeatures:\r\n - icon: \u003Ci class=\"i-carbon-sun\" />\r\n title: Feature A\r\n details: Lorem ipsum dolor sit amet, consectetur adipiscing elit\r\n```\r\n\r\nCheck the feature icon type\r\n```ts\r\ntype FeatureIcon =\r\n | string\r\n | { src: string; alt?: string; width?: string; height: string }\r\n | {\r\n light: string\r\n dark: string\r\n alt?: string\r\n width?: string\r\n height: string\r\n }\r\n```\r\n\r\nI refer to the render logic, use `v-html` render the icon.\r\nDisplay well in `dev` environment, but shows errors in `prod` environment.\r\n\r\n| dev | build |\r\n| ----------- | ----------- |\r\n|  |  |\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/github/zyyv/vitepress-unocss-issue\r\n\r\n- Display right run `pnpm dev`\r\n- Display error run `pnpm build && pnpm preview`\r\n\r\n### Expected behavior\r\n\r\nDev and build behave the same\r\n\r\n### System Info\r\n\r\n```Text\r\nlatest\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.",[3165,3168,3171],{"name":3166,"color":3167},"build","377ba8",{"name":3169,"color":3170},"has-workaround","1B4515",{"name":3172,"color":3173},"stale","ededed",4045,"SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.7337537,{"description":3180,"labels":3181,"number":3182,"owner":3155,"repository":3156,"state":3183,"title":3184,"updated_at":3185,"url":3186,"score":3187},"### Is your feature request related to a problem? Please describe.\n\nsocialLinks:[\r\n {\r\n icon: {\r\n svg: '\u003Csvg>\u003C/svg>'\r\n },\r\n link: '...' }]\n\n### Describe the solution you'd like\n\n I want this configuration to display properly. Or add QQ, WeChat, email, etc.\r\n\r\n\n\n### Describe alternatives you've considered\n\n_No response_\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] 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.",[],1115,"closed","How can I make socialLinks: this configuration can be displayed normally in config.js","2023-01-21T14:28:53Z","https://github.com/vuejs/vitepress/issues/1115",0.67275983,{"description":3189,"labels":3190,"number":3192,"owner":3155,"repository":3156,"state":3183,"title":3193,"updated_at":3194,"url":3195,"score":3196},"### Describe the bug\n\nexternalLinkIcon as true doesn't add the icon.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-ysfhai?file=docs%2F.vitepress%2Fconfig.ts\n\n### Expected behavior\n\nicon should be shown\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22621\r\n CPU: (4) x64 Intel(R) Core(TM) i5 CPU M 520 @ 2.40GHz\r\n Memory: 2.15 GB / 7.93 GB\r\n Binaries:\r\n Node: 20.10.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 10.2.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.121)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.35 => 1.0.0-rc.35\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.",[3191],{"name":3152,"color":3153},3424,"externalLinkIcon isn't working","2024-01-16T00:04:36Z","https://github.com/vuejs/vitepress/issues/3424",0.6980246,{"description":3198,"labels":3199,"number":3205,"owner":3155,"repository":3156,"state":3183,"title":3206,"updated_at":3207,"url":3208,"score":3209},"### Describe the bug\n\n# Bug\r\nSVG feature icons in the `home` layout expand to fit the width of their feature element, rather than being constrained to the size specified in their `width` declaration.\r\n\r\n\n\n### Reproduction\n\n# Context\r\nGiven the frontmatter\r\n\r\n```\r\n---\r\nlayout: home\r\n\r\nhero:\r\n name: Bug example\r\n\r\nfeatures:\r\n - icon:\r\n src: /flag-solid.svg\r\n width: 50\r\n title: Bug example\r\n details: The icon expands to fit the width of the feature element, rather than being constrained to 50px\r\n---\r\n```\n\n### Expected behavior\n\n# Expected\r\nThe feature icon is expected to size to the width specified by the `width` declaration.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10\r\n Binaries:\r\n Node: 18.13.0\r\n npm: 8.19.3\r\n Browsers:\r\n Chrome: 109\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.40 => 1.0.0-alpha.45\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.",[3200,3203,3204],{"name":3201,"color":3202},"theme","0754FB",{"name":3169,"color":3170},{"name":3172,"color":3173},1886,"SVG icons in `feature` elements do not respect their size setting","2023-08-14T00:04:27Z","https://github.com/vuejs/vitepress/issues/1886",0.6999328,{"description":3211,"labels":3212,"number":3213,"owner":3155,"repository":3156,"state":3183,"title":3214,"updated_at":3215,"url":3216,"score":3217},"### Describe the bug\n\neven without `socialLinks` option set, an empty `vp-icons.css` file will still appear in the build result.\n\n### Reproduction\n\nnone\n\n### Expected behavior\n\n`vp-icons.css` should not be included in the build result when `socialLinks` is not enabled\n\n### System Info\n\n```Text\nnone\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.",[],4869,"empty vp-icons.css file","2025-08-05T13:49:21Z","https://github.com/vuejs/vitepress/issues/4869",0.7053917,{"description":3219,"labels":3220,"number":3221,"owner":3155,"repository":3156,"state":3183,"title":3222,"updated_at":3223,"url":3224,"score":3225},"### Is your feature request related to a problem? Please describe.\n\nIn default VitePress there is `VPSocialLink` component which allows to add social icons.\r\n\r\nCould you please add one more icon for personal website here?\r\nhttps://github.com/vuejs/vitepress/blob/main/src/client/theme-default/support/socialIcons.ts\n\n### Describe the solution you'd like\n\n...\n\n### Describe alternatives you've considered\n\n_No response_\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.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.",[],2638,"Add personal website social icon","2023-07-25T00:04:47Z","https://github.com/vuejs/vitepress/issues/2638",0.7185576,{"description":3227,"labels":3228,"number":3230,"owner":3155,"repository":3156,"state":3183,"title":3231,"updated_at":3232,"url":3233,"score":3234},"### 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.",[3229],{"name":3152,"color":3153},4238,"Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.73450553,{"description":3236,"labels":3237,"number":3241,"owner":3155,"repository":3156,"state":3183,"title":3242,"updated_at":3243,"url":3244,"score":3245},"### Describe the bug\n\nHey not sure if bug or not. However when trying to add avatars on a team page while within an enterprise doesnt seem to work\r\n\r\n- is there a way to just add a .png file from the public folder to the avatar team url? \n\n### Reproduction\n\n {\r\n avatar: '/mypng.png',\r\n name: 'Jonathan Gober',\r\n title: 'QP Consultant',\r\n links: [\r\n { icon: 'github', link: 'my github link' }, \r\n ]\r\n },\r\n\r\nrunning docs:dev gives expected result and shows png\r\nrunning with built file fails\n\n### Expected behavior\n\nShould show png avatar for team page\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19042\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11850H @ 2.50GHz\r\n Memory: 16.31 GB / 31.73 GB\r\n Binaries:\r\n Node: 18.12.1 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 8.19.2 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (108.0.1462.76) \r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.30 => 1.0.0-alpha.30\n```\n\n\n### Additional context\n\nn/a\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.",[3238],{"name":3239,"color":3240},"need more info","bdbefc",1826,"Use PNG files for Team Page Avatar?","2023-01-30T00:04:20Z","https://github.com/vuejs/vitepress/issues/1826",0.73610336,{"description":3247,"labels":3248,"number":3249,"owner":3155,"repository":3156,"state":3183,"title":3250,"updated_at":3251,"url":3252,"score":3253},"### Describe the bug\n\ndoesn’t work\r\n\r\nmy website link\r\nhttps://lark-base-team.github.io/js-sdk-docs/zh/start\r\nhere is my config\r\n```\r\nexport default defineConfig({\r\n lastUpdated: true,\r\n cleanUrls: true,\r\n base: '/js-sdk-docs/',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n },\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n // sitemap: {\r\n // hostname: 'https://basejsapi.com',\r\n // },\r\n lang: 'zh',\r\n locales: {\r\n zh: {\r\n label: '中文',\r\n lang: 'zh',\r\n dir: '/zh',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n sidebar: getZhSideBar(),\r\n },\r\n },\r\n en: {\r\n label: 'English',\r\n lang: 'en',\r\n dir: '/en',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n nav: [\r\n { text: 'API', link: '/en/api/guide.md' },\r\n ],\r\n sidebar: getEnSideBar(),\r\n },\r\n }\r\n },\r\n})\r\n\r\n```\n\n### Reproduction\n\n vitepress: 1.0.0-rc.10 \n\n### Expected behavior\n\nshould dispaly the icon in tab\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 13.6\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 53.27 MB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.14.2 - ~/.nvm/versions/node/v18.14.2/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 9.5.0 - ~/.nvm/versions/node/v18.14.2/bin/npm\r\n pnpm: 8.7.4 - ~/.nvm/versions/node/v18.14.2/bin/pnpm\r\n Browsers:\r\n Chrome: 117.0.5938.149\r\n Safari: 16.6\r\n npmPackages:\r\n vitepress: 1.0.0-rc.10 => 1.0.0-rc.10\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.",[],3075,"After doing internationalization configuration, the tab icon on the browser page does not take effect.","2023-10-21T00:05:55Z","https://github.com/vuejs/vitepress/issues/3075",0.7372816,["Reactive",3255],{},["Set"],["ShallowReactive",3258],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fgOgduGOvaBAl4QpdASIrF4TypJjc5IaE0rPjXhduzLE":-1},"/vuejs/vitepress/1075"]