Starlight

Documentation site framework built on Astro that ships no JavaScript to the reader by default

As of 31 August 2026, Starlight is free to use. Starlight is the documentation theme maintained by the Astro core team, so its release cadence follows Astro rather than a separate product roadmap. Softwr lists it under Documentation. Starlight is made by The Astro Technology Company, available on Web, macOS, Windows, Linux.

Visit siteVisit Starlight

Overview

What Starlight does

Starlight is an Astro integration that turns a directory of Markdown or MDX files into a documentation site with sidebar navigation, versioned page metadata, internationalisation, dark mode and client side search. Search is handled by Pagefind, which builds a static index at compile time rather than calling a hosted search service, so a site can be served from any static host with no runtime dependency at all. What separates it from the other Astro themes is governance. Starlight is maintained inside the Astro organisation by the same people who ship Astro itself, and Astro uses it for its own documentation. That matters commercially because documentation themes are the most abandoned category in the JavaScript ecosystem, and a theme that the framework authors depend on for their own site is unlikely to be left unpatched after a major version bump. The cost is coupling: an Astro major release is also a Starlight migration. The buyers are engineering teams shipping developer facing products where the docs live in the same repository as the code and change in the same pull request. The trade off is the one that runs through every static generator. Build speed and the ability to review docs as code pull one way; letting a technical writer or a product manager publish a correction without cloning a repository, installing Node and waiting for CI pulls the other. Starlight chooses the first without hesitation, and offers nothing for the second.

What people use it for

A developer tool whose docs live in the same repository as the code and are reviewed in the same pull request
A team that already runs Astro for its marketing site and wants one build pipeline for both
Documentation that must be served from a CDN or an air gapped static host with no search backend
A multilingual open source project that needs per locale content trees and untranslated page fallback

Where it falls short

Concrete and checkable, so you can decide whether any of them matter to you. This is the half of a review a vendor will not write about Starlight.

There is no editing interface, so every correction requires a git client, a Node install and a CI run, which puts documentation changes out of reach for anyone who does not already work in a repository.
Starlight versions track Astro versions, so an Astro major release becomes a documentation site migration on someone else timeline rather than yours.
Pagefind builds the whole search index at compile time, so build duration and index size grow with page count and large documentation sets pay for it on every deploy.
There is no analytics, no feedback widget and no page level rating built in, so measuring which pages fail readers means wiring a third party script yourself.
Component overrides are limited to the slots the theme exposes, and anything outside those slots means forking the theme and inheriting the merge burden on every upgrade.

Cross-shopped

What people choose instead of Starlight

Each pairing was judged by two reviewers asking whether a buyer would genuinely weigh the two against each other. The ones that failed were deleted rather than published.

Starlightvs
Docusaurus
Docusaurus: Larger plugin ecosystem and built in documentation versioning, which Starlight leaves to you
Starlightvs
MkDocs
MkDocs: Python toolchain instead of Node, and a lower barrier for teams with no JavaScript build experience
Starlightvs
Mintlify
Mintlify: A hosted editor and preview flow for writers who cannot use git, at the cost of a subscription and vendor hosting

Pricing

What Starlight costs

Taken from the vendor's own pricing page. Prices move, so check before you buy.

Open source

Free

MIT licence
All features included
Self hosted on any static host
Community support via Discord and GitHub

Capabilities

Features

File based routing
Markdown and MDX files in src/content/docs become pages with no route configuration
Pagefind search
Static search index built at compile time, no hosted search service or API key
Internationalisation
Per locale content trees with fallback to the default language for untranslated pages
Component overrides
Named slots let you replace the header, sidebar or footer without forking the theme
Zero client JavaScript
Pages render as HTML; interactive islands are opt in per component
Expressive Code blocks
Syntax highlighting with line markers, diffs, frames and copy buttons built in
Auto generated sidebar
Sidebar can be derived from the directory structure or declared explicitly in config