\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.",[2867,2870,2873],{"name":2868,"color":2869},"build","377ba8",{"name":2871,"color":2872},"has-workaround","1B4515",{"name":2874,"color":2875},"stale","ededed",4045,"vuejs","vitepress","open","SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.73148507,{"description":2885,"labels":2886,"number":2887,"owner":2877,"repository":2878,"state":2888,"title":2889,"updated_at":2890,"url":2891,"score":2892},"### Describe the bug\n\ndidn't process local logo in home page when build\n\n### Reproduction\n\nadd a home page \r\n```\r\nlayout: home\r\nhero:\r\n name: xxx\r\n image:\r\n src: /images/xxx.jpeg\r\n...\r\n```\r\n\r\nnpm run build\r\n \n\n### Expected behavior\n\ncopy `/images/xxx.jpeg` to `dist/assets` when build\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.6\r\n CPU: (8) x64 Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz\r\n Memory: 66.69 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.0 - ~/.nvm/versions/node/v16.15.0/bin/node\r\n Yarn: 3.0.2 - /usr/local/bin/yarn\r\n npm: 8.5.5 - ~/.nvm/versions/node/v16.15.0/bin/npm\r\n Browsers:\r\n Chrome: 105.0.5195.125\r\n Firefox: 88.0\r\n Safari: 16.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.",[],1386,"closed","didn't process local logo in home page when build","2023-01-21T14:22:47Z","https://github.com/vuejs/vitepress/issues/1386",0.64796835,{"description":2894,"labels":2895,"number":2899,"owner":2877,"repository":2878,"state":2888,"title":2900,"updated_at":2901,"url":2902,"score":2903},"### Describe the bug\n\nHello, I lost my logo when deploying the website.\r\n\r\nThe following is my index.md (main page), I set my logo with `heroImage: ./img/logo.jpg`:\r\n```md\r\n---\r\nhome: true\r\nheroImage: ./img/logo.jpg\r\nheroAlt: jun.run\r\nheroText: 奔跑吧,俊!\r\ntagline: —— 前端工程师的必备知识库\r\nactionText: 开始\r\nactionLink: /js/default\r\nfeatures:\r\n - title: 简约\r\n details: 言简意赅\r\n - title: 实用\r\n details: 高频考点\r\n - title: 高效\r\n details: 图文并茂\r\nfooter: MIT Licensed | Copyright © jun.run\r\n---\r\n\r\n```\r\n\r\n\r\nWhen I run my website locally:\r\n\r\n\r\nWhen I deploy it online using Vercel:\r\n\r\n\r\nI found that logo.png is not moved to `/docs/.vitepress/dist/` when delpoying.\n\n### Reproduction\n\nclone the repo to local, and run `yarn docs:build`, or deploy directly to Vercel using `yarn docs:build`.\n\n### Expected behavior\n\n\n\n### System Info\n\n```shell\n\"vitepress\": \"^0.21.6\"\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[2896],{"name":2897,"color":2898},"bug: pending triage","e99695",505,"logo lost when deployment","2023-01-21T16:20:13Z","https://github.com/vuejs/vitepress/issues/505",0.67234886,{"description":2905,"labels":2906,"number":2908,"owner":2877,"repository":2878,"state":2888,"title":2909,"updated_at":2910,"url":2911,"score":2912},"### Describe the bug\n\nThe hero image referenced below shows up as expected in development. When building the project, it is not included in the finished build.\r\n\r\n```\r\nhero:\r\n name: \"C–ATTS\"\r\n text: \"Composite Attestations\"\r\n tagline: Composite attestations are a new type of attestation combining data from multiple sources to form a unified and verifiable credential.\r\n actions:\r\n - theme: brand\r\n text: Composite Attestations?\r\n link: /docs\r\n - theme: alt\r\n text: GitHub\r\n link: https://github.com/c-atts\r\n image: /images/diagram.png\r\n```\n\n### Reproduction\n\nGitHub: https://github.com/c-atts/web\r\n\r\nLive web: https://catts.run/\n\n### Expected behavior\n\nThe image should be included in the build and show up in the hero section on the index page.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.4\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 2.05 GB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.11.0 - ~/.nvm/versions/node/v20.11.0/bin/node\r\n npm: 10.2.4 - ~/.nvm/versions/node/v20.11.0/bin/npm\r\n pnpm: 8.15.4 - /opt/homebrew/bin/pnpm\r\n bun: 0.7.3 - ~/.bun/bin/bun\r\n Browsers:\r\n Brave Browser: 122.1.63.169\r\n Chrome: 123.0.6312.107\r\n Edge: 123.0.2420.81\r\n Safari: 17.4\r\n npmPackages:\r\n vitepress: ^1.1.0 => 1.1.0\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.",[2907],{"name":2897,"color":2898},3776,"Hero image don't get included in built website","2024-04-28T12:24:49Z","https://github.com/vuejs/vitepress/issues/3776",0.6738592,{"description":2914,"labels":2915,"number":2917,"owner":2877,"repository":2878,"state":2888,"title":2918,"updated_at":2919,"url":2920,"score":2921},"### Describe the bug\n\nimage not display at previewing, but replace with base64 string, it is ok !\r\n\r\n\n\n### Reproduction\n\n1. use `layout:home` in the index page\r\n2. configure the Hero section\r\n3. run `npm run docs:build` then `npm run docs:docs:preview` \r\n4. to preview the website\n\n### Expected behavior\n\ncan display the image by file path\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 11th Gen Intel(R) Core(TM) i5-11400F @ 2.60GHz\r\n Memory: 8.52 GB / 15.87 GB\r\n Binaries:\r\n Node: 16.13.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 8.1.2 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.57)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.48 => 1.0.0-alpha.48\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.",[2916],{"name":2897,"color":2898},2013,"image not display at previewing","2023-03-09T00:04:38Z","https://github.com/vuejs/vitepress/issues/2013",0.6878871,{"description":2923,"labels":2924,"number":2927,"owner":2877,"repository":2878,"state":2888,"title":2928,"updated_at":2929,"url":2930,"score":2931},"### 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.",[2925,2926],{"name":2897,"color":2898},{"name":2874,"color":2875},2385,"Vitepress build Problem","2023-08-18T00:04:08Z","https://github.com/vuejs/vitepress/issues/2385",0.69071853,{"description":2933,"labels":2934,"number":2936,"owner":2877,"repository":2878,"state":2888,"title":2937,"updated_at":2938,"url":2939,"score":2940},"\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\n\r\nWhen index page has a heroImage, it works in `vitepress dev docs` mode but it's not bundled as an asset with `vitepress build docs`.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\n\r\nCreate `docs/index.md`:\r\n\r\n```md\r\n---\r\nhome: true\r\nheroImage: logo.jpg\r\nheroAlt: Logo image\r\nheroText: Test\r\ntagline:\r\nactionText: Info\r\nactionLink: /info\r\n---\r\n```\r\n\r\nadd `docs/logo.jpg` and run `vitepress build docs`.\r\n\r\n**Expected behavior**\r\n\r\n`docs/logo.jpg` is bundled as a hashed file, something like `docs/.vitepress/dist/assets/logo.xxxxx.jpg`, and referenced accordingly.\r\n\r\n**System Info**\r\n- vitepress version: 0.13.2\r\n- vite version: 2.3.3\r\n- Node version: 16.0.0\r\n- OS version: macOS 11.3.1\r\n",[2935],{"name":2897,"color":2898},301,"heroImage not added to dist on build","2023-01-21T16:04:32Z","https://github.com/vuejs/vitepress/issues/301",0.6939673,{"description":2942,"labels":2943,"number":2945,"owner":2877,"repository":2878,"state":2888,"title":2946,"updated_at":2947,"url":2948,"score":2949},"### Describe the bug\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nyarn add vitepress\r\n\r\nedit package.json\r\n\r\n~~~\r\n \"scripts\": {\r\n \"docs:dev\": \"vitepress dev docs\",\r\n \"docs:build\": \"vitepress build docs\",\r\n \"docs:serve\": \"vitepress serve docs\"\r\n }\r\n~~~\r\n\r\nyarn docs:dev\r\n\r\n### Expected behavior\r\n\r\nnormal display\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: Windows 10 10.0.17763\r\n CPU: (8) x64 Intel(R) Xeon(R) CPU E3-1230 V2 @ 3.30GHz\r\n Memory: 3.25 GB / 7.93 GB\r\n Binaries:\r\n Node: 16.5.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.10 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 7.20.5 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 92.0.4515.107\r\n Edge: Spartan (44.17763.831.0)\r\n Internet Explorer: 11.0.17763.771\r\n npmPackages:\r\n vitepress: ^0.16.1 => 0.16.1\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/coc)\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.",[2944],{"name":2897,"color":2898},362,"Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.69521874,{"description":2951,"labels":2952,"number":2961,"owner":2877,"repository":2878,"state":2888,"title":2962,"updated_at":2963,"url":2964,"score":2965},"### Describe the bug\n\nJust like the Vite docs, I use custom styles in the `index.md` file using `\u003Cstyle module>`. I also use custom components in which I use `\u003Cstyle scoped>`.\r\n\r\nSince I updated from version `1.0.0` to the latest one (the one in the StackBlitz), the built page's styles are broken. In the dev preview everything looks like expected.\n\n### Reproduction\n\nOpen the StackBlitz Demo with this [link](https://stackblitz.com/edit/vite-1qtmk8?file=docs%2Findex.md).\r\n\r\nIf it does not run automatically, run `npm install && npm run dev`. It should look something like this:\r\n\r\n\r\n\r\nThen run `npm run docs:build && npm run docs:preview` and it will look like this:\r\n\r\n\r\n\r\nAs you can see, the hero image and its background are different and the cards are different as well.\n\n### Expected behavior\n\nI expected the built version to look just like the dev preview (or at least very close).\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (12) x64 AMD Ryzen 5 5500U with Radeon Graphics\r\n Memory: 6.45 GB / 15.35 GB\r\n Binaries:\r\n Node: 21.2.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 10.5.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 9.1.2 - ~\\AppData\\Roaming\\npm\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (127.0.2651.74)\r\n Internet Explorer: 11.0.19041.4355\r\n npmPackages:\r\n vitepress: ^1.3.1 => 1.3.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.",[2953,2956,2957,2960],{"name":2954,"color":2955},"help wanted","008672",{"name":2868,"color":2869},{"name":2958,"color":2959},"upstream","BF29ED",{"name":2874,"color":2875},4098,"Styling discrepancies between dev and build","2025-01-05T04:42:47Z","https://github.com/vuejs/vitepress/issues/4098",0.71050984,{"description":2967,"labels":2968,"number":2970,"owner":2877,"repository":2878,"state":2888,"title":2971,"updated_at":2972,"url":2973,"score":2974},"\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\nCan't use `img` tag in `v0.7.1` (works in `v0.7.0`).\r\n\r\n**To Reproduce**\r\n\r\n1.\r\n```sh\r\nnpm init\r\nyarn add vitepress\r\nwget -O vue.png https://upload.wikimedia.org/wikipedia/commons/thumb/9/95/Vue.js_Logo_2.svg/220px-Vue.js_Logo_2.svg.png\r\necho '' > index.md\r\n```\r\n\r\n2. `npx vitepress` – image will work in development\r\n\r\n\r\n3. `npx vitepress build`\r\n* build will fail due to https://github.com/vitejs/vite/pull/992\r\n* but even with that fix, the build will strip out `src` attribute of `img` and no image will be loaded\r\n\r\n**Expected behavior**\r\nImages should be preserved in build.\r\n\r\n**System Info**\r\n- vitepress version: 0.7.1\r\n- vite version: 1.0.0-rc.8\r\n- Node version: 15.0.1\r\n- OS version: macOS 10.16.7\r\n\r\n**Additional context**\r\n\r\nUsing an absolute URL works as expected in dev and build.\r\n",[2969],{"name":2897,"color":2898},113,"Local images stripped out in build","2023-01-21T16:24:20Z","https://github.com/vuejs/vitepress/issues/113",0.7114885,["Reactive",2976],{},["Set"],["ShallowReactive",2979],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fpl2UL8rlXjq1Ebo06Q_edFlpNLqy23hdYYRANLRrjRw":-1},"/vuejs/vitepress/3299"]