{"slug": "astro-starlight", "name": "Astro Starlight", "category": "notes", "category_name": "Notes and knowledge", "description": "", "recommenders": 4, "commenters": 7, "warners": 1, "score": 3.2, "rising": -1.31, "first": "2025-11-02", "latest": "2026-07-09", "why": "Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself.", "why_is_quote": true, "has_verdict": false, "sentiment": {"recommend": 7, "neutral": 2, "compare": 0, "warn": 1}, "spark": [1, 2, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0], "listed": true, "loved": [], "caveat": "", "short_quote": "Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself.", "kind": "", "icon": false, "domain": "astro.build", "github_repo": null, "official_url": "https://starlight.astro.build", "pricing": "", "aliases": ["Starlight", "Astro Starlight"], "verdict": null, "praise": [{"label": "", "summary": "", "quotes": [{"id": 769624672, "item_id": 48101542, "url": "https://news.ycombinator.com/item?id=48101542", "by": "trcarney", "date": "2026-05-11", "version": null, "stance": "recommend", "quote": "The whole site can be configured in the astro.config.js file and the rest is markdown.", "excerpt": "https://starlight.astro.build/ The whole site can be configured in the astro.config.js file and the rest is markdown. If you want an example you can look at sst.dev and their github repo at https://github.com/anomalyco/sst/tree/dev/www", "context": "", "use_case": "docs site", "switched_from": "", "story": "Ask HN: Best static site generator for a docs site in 2026?"}, {"id": 763973248, "item_id": 47748328, "url": "https://news.ycombinator.com/item?id=47748328", "by": "bryanhogan", "date": "2026-04-12", "version": null, "stance": "recommend", "quote": "using or taking inspiration from something like Astro Starlight or UnoCSS", "excerpt": "I mean, there's a fundamental missing understanding of how to build a coherent design, then there's also the problem of just poor implementation such as the animations. The Lua site has some problems as well, like an uncessary border, text size and spacing, even when it's this minimal. You can get much faster and better results from using or taking inspiration from something like Astro Starlight or UnoCSS Astro Starl", "context": "", "use_case": "Docs site theme", "switched_from": "", "story": "Why AI Sucks at Front End"}, {"id": 762044960, "item_id": 47627810, "url": "https://news.ycombinator.com/item?id=47627810", "by": "bryanhogan", "date": "2026-04-03", "version": null, "stance": "recommend", "quote": "I love the design of Astro Starlight ( https://starlight.astro.build/), a starter kit for documentation pages.", "excerpt": "I would be careful with calling that kind of design function over style. Modern UI design has its merits. But yes, good designs are not flashy, e.g. I love the design of Astro Starlight ( https://starlight.astro.build/), a starter kit for documentation pages. So I also took inspiration from \"simple designs\" for my personal site: https://bryanhogan.com/", "context": "", "use_case": "documentation sites", "switched_from": "", "story": "I prefer OG style websites \u2013 what are yours?"}, {"id": 760344640, "item_id": 47521540, "url": "https://news.ycombinator.com/item?id=47521540", "by": "shepherdjerred", "date": "2026-03-25", "version": null, "stance": "recommend", "quote": "I love https://starlight.astro.build", "excerpt": "I love https://starlight.astro.build", "context": "", "use_case": "documentation site", "switched_from": "", "story": "The Slow Collapse of MkDocs"}, {"id": 745773088, "item_id": 46610818, "url": "https://news.ycombinator.com/item?id=46610818", "by": "bryanhogan", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself.", "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"}]}], "caveats": [{"label": "", "summary": "", "quotes": [{"id": 732653568, "item_id": 45790848, "url": "https://news.ycombinator.com/item?id=45790848", "by": "azangru", "date": "2025-11-02", "version": null, "stance": "warn", "quote": "The new design just looks like the same generic Starlight template", "excerpt": "> - The homepage right now is extremely lightweight and uses next to no javascript. The new design just looks like the same generic Starlight template I'm not sure we want to use a javascript framework. While it provides a lot of features, bitrot in the javascript ecosystem happens at a very fast pace (and pulls in thousands of dependencies). I have sites written both in gatsby and vuepress and between major version ", "context": "", "use_case": "", "switched_from": "", "story": "Beginner-friendly, unofficial documentation for Helix text editor"}]}], "who": [], "tags": [], "use_cases": ["documentation sites", "docs site", "docs site theme", "documentation site", "docs site template"], "compared": [{"slug": "astro", "name": "Astro", "co": 3, "switched_from": 0, "switched_to": 0}, {"slug": "vitepress", "name": "VitePress", "co": 2, "switched_from": 0, "switched_to": 0}], "makers": [], "threads": [{"url": "https://news.ycombinator.com/item?id=48833116", "title": "Chatto is now Open Source", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=48092561", "title": "Ask HN: Best static site generator for a docs site in 2026?", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=47738864", "title": "Why AI Sucks at Front End", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=47627255", "title": "I prefer OG style websites \u2013 what are yours?", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=47482185", "title": "The Slow Collapse of MkDocs", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=46646645", "title": "Astro Joining Cloudflare", "mentions": 1}], "sentiment_by_month": {"2025-11": {"warn": 1, "recommend": 1}, "2025-12": {"recommend": 2}, "2026-01": {"recommend": 1, "neutral": 1}, "2026-02": {}, "2026-03": {"recommend": 1}, "2026-04": {"recommend": 1}, "2026-05": {"recommend": 1}, "2026-06": {}, "2026-07": {"neutral": 1}, "2026-08": {}, "2026-09": {}, "2026-10": {}}, "versions": [], "version_unnamed": 0, "family_ref": null, "runs_on": null, "lines": [], "quotes": [{"id": 781580305, "item_id": 48848769, "url": "https://news.ycombinator.com/item?id=48848769", "by": "fuzzy2", "date": "2026-07-09", "version": null, "stance": "neutral", "quote": "It's Astro and Astro Starlight.", "excerpt": "This should be the source: https://github.com/chattocorp/chatto/tree/main/apps/docs-website It's Astro and Astro Starlight. I feel it looks very similar to other contemporary docs website generators.", "context": "", "use_case": "", "switched_from": "", "story": "Chatto is now Open Source"}, {"id": 769624672, "item_id": 48101542, "url": "https://news.ycombinator.com/item?id=48101542", "by": "trcarney", "date": "2026-05-11", "version": null, "stance": "recommend", "quote": "The whole site can be configured in the astro.config.js file and the rest is markdown.", "excerpt": "https://starlight.astro.build/ The whole site can be configured in the astro.config.js file and the rest is markdown. If you want an example you can look at sst.dev and their github repo at https://github.com/anomalyco/sst/tree/dev/www", "context": "", "use_case": "docs site", "switched_from": "", "story": "Ask HN: Best static site generator for a docs site in 2026?"}, {"id": 763973248, "item_id": 47748328, "url": "https://news.ycombinator.com/item?id=47748328", "by": "bryanhogan", "date": "2026-04-12", "version": null, "stance": "recommend", "quote": "using or taking inspiration from something like Astro Starlight or UnoCSS", "excerpt": "I mean, there's a fundamental missing understanding of how to build a coherent design, then there's also the problem of just poor implementation such as the animations. The Lua site has some problems as well, like an uncessary border, text size and spacing, even when it's this minimal. You can get much faster and better results from using or taking inspiration from something like Astro Starlight or UnoCSS Astro Starl", "context": "", "use_case": "Docs site theme", "switched_from": "", "story": "Why AI Sucks at Front End"}, {"id": 762044960, "item_id": 47627810, "url": "https://news.ycombinator.com/item?id=47627810", "by": "bryanhogan", "date": "2026-04-03", "version": null, "stance": "recommend", "quote": "I love the design of Astro Starlight ( https://starlight.astro.build/), a starter kit for documentation pages.", "excerpt": "I would be careful with calling that kind of design function over style. Modern UI design has its merits. But yes, good designs are not flashy, e.g. I love the design of Astro Starlight ( https://starlight.astro.build/), a starter kit for documentation pages. So I also took inspiration from \"simple designs\" for my personal site: https://bryanhogan.com/", "context": "", "use_case": "documentation sites", "switched_from": "", "story": "I prefer OG style websites \u2013 what are yours?"}, {"id": 760344640, "item_id": 47521540, "url": "https://news.ycombinator.com/item?id=47521540", "by": "shepherdjerred", "date": "2026-03-25", "version": null, "stance": "recommend", "quote": "I love https://starlight.astro.build", "excerpt": "I love https://starlight.astro.build", "context": "", "use_case": "documentation site", "switched_from": "", "story": "The Slow Collapse of MkDocs"}, {"id": 746360416, "item_id": 46647526, "url": "https://news.ycombinator.com/item?id=46647526", "by": "yawnxyz", "date": "2026-01-16", "version": null, "stance": "neutral", "quote": "Cloudflare has been moving all their docs to Astro's Starlight docs framework.", "excerpt": "Surprised this isn't in the article, but Cloudflare has been moving all their docs to Astro's Starlight docs framework. I'm guessing this is a way to prioritize features for Cloudflare: > https://blog.cloudflare.com/open-source-all-the-way-down-upgrading-our-developer-documentation/", "context": "", "use_case": "", "switched_from": "", "story": "Astro Joining Cloudflare"}, {"id": 745773088, "item_id": 46610818, "url": "https://news.ycombinator.com/item?id=46610818", "by": "bryanhogan", "date": "2026-01-13", "version": null, "stance": "recommend", "quote": "Can highly recommend Astro Starlight for documentation sites, used it for multiple projects myself.", "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": 741193665, "item_id": 46324604, "url": "https://news.ycombinator.com/item?id=46324604", "by": "promiseofbeans", "date": "2025-12-19", "version": null, "stance": "recommend", "quote": "Astro\u2019s starlight docs generator/template is quite nice as well", "excerpt": "Astro\u2019s starlight docs generator/template is quite nice as well: https://starlight.astro.build/", "context": "", "use_case": "Docs site template", "switched_from": "", "story": "We pwned X, Vercel, Cursor, and Discord through a supply-chain attack"}, {"id": 738059906, "item_id": 46128744, "url": "https://news.ycombinator.com/item?id=46128744", "by": "bryanhogan", "date": "2025-12-02", "version": null, "stance": "recommend", "quote": "Astro Starlight", "excerpt": "Honestly, there are some easier ways out there now, although of course no solution is perfect. For non-technical people I'd recommend the Hostinger Website Builder, Obsidian Quartz or Astro Starlight. Although as a front-end dev I'd choose building a custom page with Astro, which has now become much easier though with good templates available + LLM assistance. I wrote a comparison of less-technical ways to build a we", "context": "", "use_case": "", "switched_from": "", "story": "Free static site generator for small restaurants and cafes"}, {"id": 733873616, "item_id": 45867101, "url": "https://news.ycombinator.com/item?id=45867101", "by": "bryanhogan", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "Astro Starlight[1] has been by far the best in recent times.", "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"}, {"id": 732653568, "item_id": 45790848, "url": "https://news.ycombinator.com/item?id=45790848", "by": "azangru", "date": "2025-11-02", "version": null, "stance": "warn", "quote": "The new design just looks like the same generic Starlight template", "excerpt": "> - The homepage right now is extremely lightweight and uses next to no javascript. The new design just looks like the same generic Starlight template I'm not sure we want to use a javascript framework. While it provides a lot of features, bitrot in the javascript ecosystem happens at a very fast pace (and pulls in thousands of dependencies). I have sites written both in gatsby and vuepress and between major version ", "context": "", "use_case": "", "switched_from": "", "story": "Beginner-friendly, unofficial documentation for Helix text editor"}]}