docs: adopt @nebari/starlight shared theme plugin#127
Merged
Conversation
Replace the hand-rolled Starlight theming with the published
@nebari/starlight v0.2.0 plugin so the docs site inherits Nebari's
shared identity (brand colors, self-hosted fonts, logo, favicon,
footer, and GitHub link) and picks up future theme releases.
- Wire plugins:[nebari({ logoHref })] into astro.config; on the portal
the header logo returns users to the pack catalog.
- Drop the React/Tailwind/base-ui UI stack and the custom SocialIcons
RepoButton in favor of the theme's default GitHub social link.
- Remove the superseded token/theme CSS, Geist/IBM Plex fonts, custom
logo assets, and the now-dead shadcn config.
- Bump astro to ^7.0.6 to satisfy the plugin peer range.
|
📄 Docs preview for |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Switches the docs site to the published
@nebari/starlighttheme plugin (v0.2.0, the current release) instead of the theming we had hand-rolled inastro.config.mjs.Adding
plugins: [nebari({ logoHref: 'https://packs.nebari.dev/' })]pulls in the shared Nebari identity: brand colors, self-hosted fonts, logo, favicon, footer, and a GitHub link. It also means we track future theme releases instead of maintaining our own copy of the tokens.Changes
nebari()plugin into the Starlight config.logoHrefpoints the header logo at the portal root, so it returns to the pack catalog when the site is served underpacks.nebari.dev/llm-serving-pack/.SocialIcons/RepoButtonoverride and the React/Tailwind/base-ui stack that only existed to support it. The theme ships its own GitHub link.nebari-tokens.cssandstarlight-theme.css, the Geist and IBM Plex font deps, the custom logo SVGs, and the now-dead shadcncomponents.json.astroto^7.0.6for the plugin's peer range.Verification
npm test: 10/10 passnpm run buildwith productionBASE/SITE: 10 pages, mermaid + Pagefind + sitemap all builtscripts/check-links.sh:LINKS_OK--nbr-*tokens and the theme's self-hosted fonts present, favicon and footer from the theme,logoHrefand base path applied correctly.Preview deploys through the existing Cloudflare Pages workflow.