For Astro sites and Starlight docs
AI chatbot for Astro — drop-in script for the islands framework
Astro is the modern hybrid SSR/SSG framework where every component opts-in to client JS. The Ashh widget script is fully compatible with Astro's islands architecture — drop it in your BaseHead.astro or layout, and the bot ships zero JS until the visitor opens the chat bubble.
Drop in BaseHead.astro or a Layout
Add the script tag to your src/components/BaseHead.astro (or wherever your layout includes the head). Astro's defer behavior + the widget's defer attr cooperate — no impact on TTFB.
Compatible with Starlight docs
Astro Starlight (the docs framework) supports custom head via the head config. Drop in the Ashh snippet — your docs gain an AI assistant trained on the docs themselves. Loop closes nicely.
Trained on your Astro content
Point Ashh at your sitemap. We crawl your Astro pages + content collections. New blog post or doc? In the bot's knowledge by tomorrow.
Zero impact on Astro's zero-JS guarantee
The widget script is async + defer. Astro's "ship zero JS" promise stays intact — the chat bubble is the only widget JS, lazy-loaded on demand.
Questions Astro sites and Starlight docs ask
Where exactly do I add the script in Astro?+
src/components/BaseHead.astro (or wherever your shared head lives) → add the Ashh script tag to the head. Build, deploy. Done.
Does it work with Astro's content collections?+
Yes via sitemap crawl. As long as your collections render to public URLs in your sitemap, Ashh ingests them. Astro's getCollection() content is included by default if you're using Astro's sitemap integration.
Will it work with Starlight's search?+
Yes alongside. Starlight's built-in search (Pagefind) is keyword-based. Ashh is natural-language Q&A. Many docs sites run both: Pagefind for "where do I find X" lookups, Ashh for "how do I do Y" questions.
How does it compare to Algolia DocSearch?+
DocSearch is free for open-source docs + paid for commercial; it's search, not Q&A. Ashh is a chatbot that can answer "how do I configure X with Y?" in conversation. Complementary — many sites run both.
Try it on your astro site in 5 minutes.
Free tier is genuinely free. No card required to ship a bot.
