{"slug": "vitepress", "name": "VitePress", "category": "notes", "category_name": "Notes and knowledge", "description": "", "recommenders": 3, "commenters": 5, "warners": 0, "score": 3.119, "rising": -0.98, "first": "2025-11-09", "latest": "2026-06-11", "why": "all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]", "why_is_quote": true, "has_verdict": false, "sentiment": {"recommend": 4, "neutral": 2, "compare": 0, "warn": 0}, "spark": [1, 0, 2, 0, 0, 0, 0, 1, 0, 0, 0, 0], "listed": true, "loved": [], "caveat": "", "short_quote": "all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]", "kind": "", "icon": true, "domain": "vitepress.dev", "github_repo": null, "official_url": "https://vitepress.dev", "pricing": "", "aliases": ["VitePress"], "verdict": null, "praise": [{"label": "", "summary": "", "quotes": [{"id": 774904546, "item_id": 48431534, "url": "https://news.ycombinator.com/item?id=48431534", "by": "nimonian", "date": "2026-06-06", "version": null, "stance": "recommend", "quote": "make a viteperess subsite in your repo, have the agents maintain it", "excerpt": "I do quite a lot of what this post describes in a reasonably large project. Here's what works for me: - write gherkin features for new features; update them for enhancements; don't touch them for refactors. Label your PRs with these nouns. - use pre-push hooks for type checks, linting, unit tests, and other quick, scriptable validations. - make a viteperess subsite in your repo, have the agents maintain it - document", "context": "works on a reasonably large project with agents", "use_case": "agent-maintained docs site", "switched_from": "", "story": "Harness engineering: Leveraging Codex in an agent-first world"}, {"id": 745773089, "item_id": 46610818, "url": "https://news.ycombinator.com/item?id=46610818", "by": "bryanhogan", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]", "excerpt": "I do have to say that all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]. Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself. [1]: https://starlight.astro.build/ [2]: https://vitepress.dev/", "context": "", "use_case": "documentation sites", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 745753920, "item_id": 46609620, "url": "https://news.ycombinator.com/item?id=46609620", "by": "phcreery", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "the vitepress docs I have built and used are good", "excerpt": "vitepress seems to use https://github.com/lucaong/minisearch/ and the vitepress docs I have built and used are good.", "context": "", "use_case": "", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 733873617, "item_id": 45867101, "url": "https://news.ycombinator.com/item?id=45867101", "by": "bryanhogan", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "Only Vitepress comes close.", "excerpt": "Interested to look into this more, but Astro Starlight[1] has been by far the best in recent times. Only Vitepress comes close. [1]: https://starlight.astro.build/getting-started/", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}], "caveats": [], "who": [{"by": "nimonian", "context": "works on a reasonably large project with agents", "url": "https://news.ycombinator.com/item?id=48431534", "date": "2026-06-06"}], "tags": [], "use_cases": ["documentation site", "agent-maintained docs site", "documentation sites"], "compared": [{"slug": "astro-starlight", "name": "Astro Starlight", "co": 2, "switched_from": 0, "switched_to": 0}], "makers": [], "threads": [{"url": "https://news.ycombinator.com/item?id=46596823", "title": "You Don't Need Mintlify", "mentions": 2}, {"url": "https://news.ycombinator.com/item?id=48449187", "title": "Ask HN: What are tools you have made for yourself since the advent of AI", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=48416264", "title": "Harness engineering: Leveraging Codex in an agent-first world", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=48178652", "title": "Learn Harness Engineering", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=45865189", "title": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team", "mentions": 1}], "sentiment_by_month": {"2025-11": {"recommend": 1}, "2025-12": {}, "2026-01": {"recommend": 2}, "2026-02": {}, "2026-03": {}, "2026-04": {}, "2026-05": {"neutral": 1}, "2026-06": {"recommend": 1, "neutral": 1}, "2026-07": {}, "2026-08": {}, "2026-09": {}, "2026-10": {}}, "versions": [], "version_unnamed": 0, "quotes": [{"id": 775826019, "item_id": 48489126, "url": "https://news.ycombinator.com/item?id=48489126", "by": "mutahirs", "date": "2026-06-11", "version": null, "stance": "neutral", "quote": "created a vitepress site with it", "excerpt": "I used notebook LM and claude/gemini to gather the notes on K8s and created a vitepress site with it. Claude/gemini helped with design and content meta. NLM for content with official sources. https://randomwrites.com I am doing a similar with linux internals (to be published soon). ofcourse from the official docs and asking some questions around the concepts i like and forget mostly :-)", "context": "", "use_case": "documentation site", "switched_from": "", "story": "Ask HN: What are tools you have made for yourself since the advent of AI"}, {"id": 774904546, "item_id": 48431534, "url": "https://news.ycombinator.com/item?id=48431534", "by": "nimonian", "date": "2026-06-06", "version": null, "stance": "recommend", "quote": "make a viteperess subsite in your repo, have the agents maintain it", "excerpt": "I do quite a lot of what this post describes in a reasonably large project. Here's what works for me: - write gherkin features for new features; update them for enhancements; don't touch them for refactors. Label your PRs with these nouns. - use pre-push hooks for type checks, linting, unit tests, and other quick, scriptable validations. - make a viteperess subsite in your repo, have the agents maintain it - document", "context": "works on a reasonably large project with agents", "use_case": "agent-maintained docs site", "switched_from": "", "story": "Harness engineering: Leveraging Codex in an agent-first world"}, {"id": 770975136, "item_id": 48185946, "url": "https://news.ycombinator.com/item?id=48185946", "by": "argee", "date": "2026-05-18", "version": null, "stance": "neutral", "quote": "which looks interesting", "excerpt": "AI slop aside, looks like this website is built with Vitpress [0] which looks interesting. [0] https://vitepress.dev/", "context": "", "use_case": "", "switched_from": "", "story": "Learn Harness Engineering"}, {"id": 745773089, "item_id": 46610818, "url": "https://news.ycombinator.com/item?id=46610818", "by": "bryanhogan", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]", "excerpt": "I do have to say that all of the doc tools they mention in the beginning are worse than Astro Starlight[1] and Vitepress[2]. Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself. [1]: https://starlight.astro.build/ [2]: https://vitepress.dev/", "context": "", "use_case": "documentation sites", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 745753920, "item_id": 46609620, "url": "https://news.ycombinator.com/item?id=46609620", "by": "phcreery", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "the vitepress docs I have built and used are good", "excerpt": "vitepress seems to use https://github.com/lucaong/minisearch/ and the vitepress docs I have built and used are good.", "context": "", "use_case": "", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 733873617, "item_id": 45867101, "url": "https://news.ycombinator.com/item?id=45867101", "by": "bryanhogan", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "Only Vitepress comes close.", "excerpt": "Interested to look into this more, but Astro Starlight[1] has been by far the best in recent times. Only Vitepress comes close. [1]: https://starlight.astro.build/getting-started/", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}