Promptless Now Supports Starlight (Astro) as a Docs Platform
Promptless now supports Starlight, the Astro-based documentation framework. If your docs live on Starlight, onboarding Promptless no longer requires manual configuration. Promptless detects your Astro config automatically and applies the right defaults.
We’ve been running our own docs on Starlight for a while, so adding support was overdue.
The problem
Section titled “The problem”Until now, if you used Starlight, you configured Promptless manually. You’d pick “other” during onboarding, point Promptless at your docs repo, and match the conventions by hand. That worked, but it was friction we put on you instead of handling ourselves.
Starlight has been picking up as a docs choice. Our team uses it, and more customers have been arriving on it. Direct support was the right default.
How it works
Section titled “How it works”Starlight is now an option in the onboarding hosting provider dropdown. Selecting it applies the right defaults for Astro docs sites.
You usually won’t need to select it. Promptless looks for astro.config.mjs, astro.config.ts, or astro.config.js in your docs repo and auto-detects Starlight.
Promptless also reads the site field from your Astro config to determine your docs URL. Earlier onboarding would sometimes pick up the “Edit this page” link and point at your GitHub repo instead of your docs site. That’s fixed. Fallback patterns like site: process.env.SITE_URL || 'https://yourdocs.com' now resolve correctly.
Who benefits most
Section titled “Who benefits most”Teams on Astro and Starlight onboarding for the first time. Point Promptless at your docs repo, confirm Starlight in the detected field, and continue.
Teams migrating to Starlight from another platform. Detection handles the config change. The base URL updates automatically.
Teams already running Promptless against a Starlight site with manual config. Re-run onboarding to pick up the Starlight-specific defaults, or ask us to migrate the config for you.
How to use it
Section titled “How to use it”New onboarding: pick Starlight from the hosting provider dropdown, or let detection handle it. No additional configuration.
Already onboarded on a Starlight site: your existing setup keeps working. Re-run onboarding if you want the improved defaults.
What’s next
Section titled “What’s next”We’ll keep adding platform support. If you’re on a framework that isn’t supported yet, tell us.