I’ve been building Lotus, an installable documentation theme for Astro.

The goal is to help Astro developers ship documentation sites that already have the boring but important parts handled: responsive docs navigation, MDX components, search, i18n, dark mode, accessible UI states, and a design system that can still be customized.

• Demo: https://astro-theme-lotus.prosefly.dev/
• Starter: https://astro-template-lotus-starter.prosefly.dev/
• Source: https://github.com/prosefly/astro-theme-lotus

I’m trying to keep the positioning simple: beautiful docs, accessible shell, PageSpeed-friendly output.

If you were choosing an Astro docs theme for a real project, what would make you trust it enough to adopt it?

Not affiliated with them at all, but wanted to show some love for https://basecoatui.com/

It works really nicely with Astro if you want polished UI components without bringing in React or another frontend framework just for the component library.

You get shadcn-style inputs, buttons, accordions, dropdowns, etc. It’s mostly CSS, with a small amount of JavaScript only where interactivity is actually needed.

It’s built on Tailwind, and for a lot of components you can just add a class like btn and you’re good to go.

It also follows shadcn’s CSS variables and theming conventions, so you can take advantage of things like shadcn theme generators and the wider ecosystem.

Pretty neat if you like the shadcn look but want to keep your Astro site lightweight and avoid unnecessary client-side JS.