Summary
Add a base Astro site using the Starlight docs framework to this repo under a new docs/ directory, following the established pattern from other software packs (e.g. nebari-chat-pack, mlflow-pack, harbor-pack). This is an experimental addition — the initial site will contain only placeholder "coming soon" content, establishing the scaffolding for future documentation of the pack.
Motivation
- Nearly all other software packs already ship a
docs/ Starlight site; this pack should match that convention
- The shared
@nebari/starlight theme plugin provides Nebari branding (colors, fonts, logo, favicon, footer) for free — no custom styling work needed
- Starlight provides search, sidebar navigation, and dark mode out of the box, so docs authors only write markdown
- Getting the scaffolding merged early lets docs content land incrementally in follow-up PRs
Acceptance Criteria
Out of Scope
- Writing actual documentation content (follow-up issues once the scaffold lands)
- Deployment/hosting of the docs site (CI publish workflow handled separately)
- Changes to the shared
@nebari/starlight theme plugin itself
- Documenting the Helm chart,
Tiltfile, or extensions/ internals in this pass
Summary
Add a base Astro site using the Starlight docs framework to this repo under a new
docs/directory, following the established pattern from other software packs (e.g.nebari-chat-pack,mlflow-pack,harbor-pack). This is an experimental addition — the initial site will contain only placeholder "coming soon" content, establishing the scaffolding for future documentation of the pack.Motivation
docs/Starlight site; this pack should match that convention@nebari/starlighttheme plugin provides Nebari branding (colors, fonts, logo, favicon, footer) for free — no custom styling work neededAcceptance Criteria
docs/directory containing a base Astro project with the@astrojs/starlightintegration, mirroring the structure used in other packs (astro.config.mjs,src/content/,public/)@nebari/starlighttheme plugin withnebari({ logoHref: 'https://packs.nebari.dev/' }), matching sibling packsastro.config.mjsrespects theBASEandSITEenv vars for portal deployment, as the other packs donpm install && npm run devserves the site locally without errorsnpm run buildproduces a static build without errorsREADME.mdupdated with a short note pointing to thedocs/directory and how to run it locallyOut of Scope
@nebari/starlighttheme plugin itselfTiltfile, orextensions/internals in this pass