by pmig on 5/23/25, 5:15 PM with 28 comments
by suryao on 5/27/25, 9:26 PM
It looks great out of the box and supports a product switcher, which can be used for maintaining related products or product versions. It also supports OpenAPI imports and API playgrounds.
The best part is that it is just a fully fledged (nextjs) app that is entirely customizable with relative ease. We just moved to it from Docusaurus and couldn't be happier.
by quintu5 on 5/27/25, 9:52 PM
by MrDarcy on 5/27/25, 7:16 PM
by rxliuli on 5/28/25, 1:51 PM
by swyx on 5/30/25, 7:22 AM
what is the cause for this?
by willwade on 5/27/25, 7:12 PM
> When I tried to create marketing pages with Starlight in addition to the technical documentation, I nearly gave up. Coming from the Docusaurus world, this wasn't an issue as the starter template comes with a front page and a blog out of the box. You can even create multiple documentations on different paths. We used /docs, for example.
> Starlight, on the other hand, is only built for documentation and not for marketing pages. It even took an ugly hack to make sure the default path is /docs and not /.
> Please don't look at this custom script configured in our astro.config.mjs we need to execute on every page to make sure that the redirection works properly
Love the straight talking. Refreshing in the period of ai slop blogposts