Astro and Starlight
Decision date: 2026-10-04. Status: accepted for this implementation.
Context
Section titled “Context”The assignment fixes Option A and requires static content, native navigation and search. The standalone documentation repository owns this website stack independently of the public platform implementation.
Considered alternatives
Section titled “Considered alternatives”Considered: stock starter styling, custom framework, or supported Starlight overrides. Framework substitution is outside this assignment.
Decision
Section titled “Decision”Use locked Astro 7.3.5 and Starlight 0.42.5 with supported content loaders and Hero/MarkdownContent overrides.
Consequences
Section titled “Consequences”Native navigation and Pagefind reduce custom logic. Upgrades require runtime/peer API review and integrated tests.
Maintained by Satyam Agnihotri · DevOps & Cloud Engineer