Best Starlight Plugins — By Purpose

A curated “best of” cut of Starlight plugins, organized by what you’re trying to improve. This is the recommended shortlist — for the exhaustive catalog see the official Starlight plugins resource. ⭐ = official-grade (mostly by HiDeoo, a Starlight core maintainer — the safest to depend on).

🎨 UI — Visual / Layout

Plugin	Use it for	Tier	URL
A theme (Black / Lucode / Rapide)	Biggest single UI lever — restyle the whole site	popular	see `Best-Starlight-Docs-Themes.md`
starlight-image-zoom	Click-to-zoom images (legible screenshots)	⭐	https://github.com/HiDeoo/starlight-image-zoom
starlight-plugin-icons	Icons in sidebar, code blocks, file tree	popular	https://github.com/Rettend/starlight-plugin-icons
starlight-heading-badges	Badges on headings (New / Beta / Deprecated)	⭐	https://github.com/HiDeoo/starlight-heading-badges
starlight-ui-tweaks	Custom nav links, marketing footer, cleaner theme toggle	popular	https://github.com/dlcastillop/starlight-ui-tweaks

Often a theme + ~20 lines of customCss (your 2–3 color palette) beats stacking UI plugins.

Plugin	Use it for	Tier	URL
starlight-sidebar-topics	Split docs into sections, each with its own sidebar (Docs / API / Tutorials)	⭐	https://github.com/HiDeoo/starlight-sidebar-topics
starlight-auto-sidebar	Tweak autogenerated sidebar groups (order, labels, badges)	⭐	https://github.com/HiDeoo/starlight-auto-sidebar
starlight-sidebar-swipe	Swipeable mobile sidebar (Discord-style)	popular	https://github.com/trueberryless-org/starlight-sidebar-swipe
starlight-scroll-to-top	Scroll-to-top button	popular	https://github.com/frostybee/starlight-scroll-to-top
starlight-telescope	Fuzzy, keyboard-first page jumper	popular	https://frostybee.github.io/starlight-telescope/
star-warp	”Warp-drive” jump through search results	popular	https://inox-tools.fryuni.dev/star-warp
starlight-tags	Tag pages for organization + discovery	popular	https://frostybee.github.io/starlight-tags/
starlight-site-graph	Interactive site graph in sidebar (Obsidian-style)	popular	https://github.com/Fevol/starlight-site-graph
starlight-fullview-mode	Collapse sidebars for fullscreen reading	popular	https://github.com/WindMillCode/starlight-fullview-mode

⚡ Performance — (mostly already handled)

Honest take: Starlight is fast by default — there’s almost nothing to “install” for performance. What actually matters:

✅ Built in: Pagefind static search (no backend), zero-JS islands (pages ship no framework JS unless you add an island), automatic asset optimization.
✅ Render diagrams at build time, not in the browser: use astro-d2 (https://github.com/HiDeoo/astro-d2) or astro-mermaid so diagrams cost zero client JS.
✅ Keep search static — stick with Pagefind unless you genuinely need Algolia/Typesense; hosted search adds a network round-trip.
⚠️ Watch what hurts perf: heavy interactive islands (client:load everywhere), large web fonts (Starlight defaults to system fonts on purpose), unoptimized images. These are your choices, not plugin fixes.
🔧 Astro-native levers (not Starlight plugins): <Image> optimization, link prefetch, and an SSR adapter only if you actually need SSR.

There is no “make it faster” plugin worth installing — the win is not slowing it down.

🔍 Search

Option	Use it for	Tier	URL
Pagefind (built-in)	Default static search — keep this unless you outgrow it	built-in	(default)
Algolia DocSearch	Big sites, hosted relevance + analytics	official	https://starlight.astro.build/guides/site-search/#algolia-docsearch
starlight-docsearch-typesense	Self-hosted DocSearch alternative	popular	https://github.com/typesense/starlight-docsearch-typesense

🧩 Features / Additions

Plugin	Use it for	Tier	URL
starlight-openapi	Auto-generate API reference from OpenAPI/Swagger	⭐	https://github.com/HiDeoo/starlight-openapi
starlight-typedoc	API docs from TypeScript via TypeDoc	⭐	https://github.com/HiDeoo/starlight-typedoc
starlight-versions	Version your documentation	⭐	https://github.com/HiDeoo/starlight-versions
starlight-blog	Add a blog to your docs	⭐	https://github.com/HiDeoo/starlight-blog
starlight-changelogs	Display changelogs alongside docs	⭐	https://github.com/HiDeoo/starlight-changelogs
starlight-package-managers	npm/pnpm/yarn/bun install-command tabs	⭐	https://github.com/HiDeoo/starlight-package-managers
starlight-github-alerts	Render GitHub `> [!NOTE]` alerts as asides	⭐	https://github.com/HiDeoo/starlight-github-alerts
starlight-videos	Video guides & courses	⭐	https://github.com/HiDeoo/starlight-videos
starlight-kbd	Document keyboard shortcuts	⭐	https://github.com/HiDeoo/starlight-kbd
starlight-markdown-blocks	Custom block/aside types	popular	https://delucis.github.io/starlight-markdown-blocks/
starlight-giscus	GitHub Discussions comments	popular	https://github.com/dragomano/starlight-giscus
FeelBack	User feedback widget on pages	popular	https://www.feelback.dev/

🤖 AI / LLM additions (on-brand for you)

Plugin	Use it for	Tier	URL
starlight-llms-txt	Generate `llms.txt` so AI agents ingest your docs cleanly	⭐	https://github.com/delucis/starlight-llms-txt
starlight-contextual-menu	”Copy for LLM” / open-in-ChatGPT actions	popular	https://github.com/corsfix/starlight-contextual-menu
starlight-copy-button	Copy whole page as Markdown	popular	https://github.com/dionysuzx/starlight-copy-button

✅ Quality / Maintenance

Plugin	Use it for	Tier	URL
starlight-links-validator	Catch broken internal links at build	⭐	https://github.com/HiDeoo/starlight-links-validator
starlight-auto-drafts	Auto-hide draft pages in production	⭐	https://github.com/HiDeoo/starlight-auto-drafts

📂 Directories & Structured Content — the honest answer

There is no dedicated “directory site” plugin for Starlight. Two paths:

Path 1 — Ready-made structured-content plugins (directory-adjacent)

These give you listing/catalog-style pages out of the box for specific shapes:

Plugin	Gives you	URL
starlight-blog	A post listing + index (blog-shaped directory)	https://github.com/HiDeoo/starlight-blog
starlight-changelogs	A changelog listing	https://github.com/HiDeoo/starlight-changelogs
starlight-recipes	A recipe-website template (closest thing to a “directory of items”)	https://github.com/trueberryless-org/starlight-recipes

Path 2 — Build it yourself (the real directory answer)

For an actual catalog/listing (e.g. PharmKit’s ~120 tools, a glossary, an integrations index) there’s no plugin — you build it with Astro primitives, which is straightforward:

Content collection for the data (JSON / Markdown / Supabase fetch)
<StarlightPage> to keep the Starlight shell
Card / CardGrid for the grid, or a React table island for search/filter/sort
getStaticPaths for per-item detail pages

➡️ Full copy-paste recipes (incl. a working searchable React table) are in Starlight-Directories-And-Data-Recipes.md.

Rule of thumb: if it’s a listing of your own content, build it (Path 2). If the directory needs user submissions / auth / payments, it’s not a docs-theme job — use plain Astro or Next.js.

🚀 Committed Starter Pack (Install These First)

For any Zajaly product docs site, this is the baseline — adopt and move on:

pnpm add starlight-links-validator starlight-package-managers \
  starlight-image-zoom starlight-github-alerts

starlight-links-validator — never ship a broken link.
starlight-package-managers — clean install-command tabs.
starlight-image-zoom — legible screenshots.
starlight-github-alerts — paste alerts straight from your READMEs.

Add when the need appears:

API/SDK product → starlight-openapi or starlight-typedoc
1 doc area → starlight-sidebar-topics
release notes → starlight-blog + starlight-changelogs
AI-brand polish → starlight-llms-txt (+ a copy-for-LLM button)
multi-version → starlight-versions
a theme → see Best-Starlight-Docs-Themes.md

Checklist (Things You Might Have Missed)

☐ Don’t over-install. Every plugin is build weight + an upgrade liability. The starter pack covers most sites.
☐ There’s no “performance plugin” — Starlight is fast by default; the job is to not slow it down (heavy islands, big fonts, unoptimized images).
☐ Prefer ⭐ HiDeoo/core-dev plugins for anything load-bearing (openapi, typedoc, versions, blog, links-validator) — they track Starlight releases.
☐ Directories = build-it-yourself (no plugin); the structured-content plugins (blog/changelog/recipes) only cover their specific shapes.
☐ llms.txt is cheap + on-brand for an AI builder — install early.
☐ Themes are the biggest UI win — start there before stacking UI plugins.
☐ Starlight is 0.x — pin versions; check plugin compatibility before bumping.

Maintained for the Zajaly stack. Companion to the rest of the reference set. Curated from the official Starlight plugins catalog (current as of June 2026).

Metadata

Created: 2026-06-08
Version: v1.0
Starlight version referenced: v0.39.x
Changelog:
- v1.0 (2026-06-08) — Best-of plugins by purpose (UI / UX / performance / search / features / AI / quality), honest performance section, directories ready-made-vs-build answer, committed starter pack, missed-items checklist.