Awesome Starlight

A curated list of awesome things related to Astro Starlight - automatically updated weekly!

Starlight is a full-featured documentation theme built on top of the Astro framework. It's designed to help you build beautiful, high-performance, and accessible documentation sites.

⚡ This list is automatically updated every week with the latest plugins, themes, tools, and showcases from the Starlight ecosystem.

Official Resources

Official Website - Official Starlight documentation site.
GitHub Repository - Official Starlight source code.
Translation Tracker - Track progress of pages translated into different languages.
Astro Documentation - Official Astro framework documentation.

Tutorials & Guides

Getting Started

Official Tutorial - Step-by-step guide to build your first Starlight site.
Astro Tutorial - Learn Astro fundamentals.

Deployment

Deploy to Netlify - Deploy your Starlight site to Netlify.
Deploy to Vercel - Deploy your Starlight site to Vercel.
Deploy to GitHub Pages - Deploy your Starlight site to GitHub Pages.
Deploy to Cloudflare Pages - Deploy your Starlight site to Cloudflare Pages.

Customization

CSS & Styling - Customize the look of your site.
Internationalization (i18n) - Make your docs multilingual.
Sidebar Configuration - Configure your site's navigation.
Authoring Content - Write content in Markdown or MDX.
Custom Components Guide - Create custom components.
Overriding Components - Override built-in components.

Plugins & Integrations

astro-d2 - Transform D2 Markdown code blocks into diagrams.
astro-live-code - Render your MDX code blocks as interactive components
astro-mermaid - Client-side render Mermaid content in Markdown code blocks.
astro-plantuml - Render PlantUML content in Markdown code blocks.
astro-starlight-remark-asides - Use remark directives to get asides in .md/.mdx styled like starlight's asides
Axiom Studio for Starlight - A local-first browser editor for editing Markdown and MDX pages, managing frontmatter, and previewing Starlight docs without touching raw files.
contentisland-cli - Connect and sync your Starlight project to Content Island Headless CMS to edit and manage your documentation.
@stellayazilim/mcp-starlight - Give any Astro Starlight docs site an MCP server. Build-time catalog + stdio server over npx — no hosting required, works on GitHub Pages. Locale- and version-aware.
mkdocs-material-to-starlight - Migrate MkDocs Material sites to Astro Starlight in one command. Maps pages, plugins, sidebar, redirects, and i18n; reports anything left over with file:line diagnostics.
notion-to-astro - Convert Notion exports to Astro Starlight docs
star-warp - Warp-drive through search results in your documentation.
@astrojs/starlight - Build beautiful, high-performance documentation websites with Astro
@bablr/starlight - Build beautiful, high-performance documentation websites with Astro
starlight-agentready - Submit your docs to AgentReady after every build, making them queryable by AI agents via MCP.
starlight-agentready - Starlight plugin that submits your docs to AgentReady after every build, making them instantly queryable by AI agents via MCP.
starlight-ai-label - Starlight plugin to add EU AI Act-style AI content-disclosure badges to your docs pages.
starlight-announcement - Add enhanced announcement banners with dismissibility, variants, scheduling, and page targeting for your Starlight docs.
starlight-announcement - A plugin to add custom announcements to your Starlight docs.
starlight-auto-drafts - Tweak draft pages default behavior and automatically remove sidebar links to draft pages in production mode.
starlight-auto-sidebar - Tweak your autogenerated sidebar groups.
starlight-base-path - Prepend your configured base path to links in your content automatically.
starlight-biel - Add an Ask AI chatbot that answers from your content, powered by Biel.ai.
starlight-biel - Ask AI bot for technical documentation.
starlight-blog - Add a blog to your documentation site.
starlight-cannoli-plugins - Starlight plugins for automatic sidebar generation and link validation
starlight-changelogs - Display changelogs alongside your project documentation.
@gesslar/starlight-class-browser - Swagger-style API documentation component set that renders class, method, property, and type documentation with theme-aware syntax highlighting — all in the light DOM.
@gesslar/starlight-class-browser - A class browser for starlight/astro-based things.
starlight-codeblock-fullscreen - Add fullscreen toggle functionality to Expressive Code blocks in your documentation.
starlight-contextual-menu - Add a contextual menu to your Starlight documentation.
starlight-contributor-list - Display a list of all contributors to your project.
starlight-cooler-credit - Add a nice credit to Starlight or Astro at the bottom of the table of contents.
starlight-cooler-credit - Add a nice credit to Starlight or Astro at the bottom of Table of Contents.
starlight-copy-button - Copy full docs page Markdown with a polished button in the page title.
starlight-copy-inline-code - A Starlight plugin that adds copy buttons to inline code elements
starlight-dbt - A Starlight plugin for dbt docs integration
starlight-digital-garden - Digital garden for starlight
starlight-docsearch-typesense - A Typesense-powered alternative to the official Algolia DocSearch plugin.
@entro314labs/starlight-document-converter - A document converter for Astro Starlight that transforms various document formats into Starlight-compatible Markdown with proper frontmatter
starlight-dot-md - A Starlight plugin that exposes raw markdown files at .md URLs.
starlight-fsharp-literate - F# Literate (.fsx) file support for Astro Starlight
starlight-fullview-mode - Collapse sidebars and expand content for a fullscreen experience.
starlight-giscus - Add Giscus comments to your docs site.
starlight-github-alerts - Render GitHub alerts as Starlight asides.
starlight-glide - A premium, modular Table of Contents indicator for Starlight documentation.
starlight-gtm - Starlight plugin for Google Tag Manager
starlight-heading-badges - Add badges to your Markdown and MDX headings.
starlight-i18n - Visual Studio Code extension to help translate Starlight pages.
starlight-image-zoom - Add zoom capabilities to your documentation images.
starlight-katex - Starlight plugin for Katex
starlight-kbd - Document keyboard shortcuts with ease.
starlight-links - Visual Studio Code extension providing IntelliSense for Starlight Markdown and MDX content links.
starlight-links-validator - Check for broken links in your Starlight pages.
starlight-llm-actions - Starlight plugin: Page Actions dropdown with Copy/View/PDF and Open-in-LLM buttons (ChatGPT, Claude, Gemini, Perplexity, T3 Chat, Cursor, Copilot).
starlight-llm-button - Add a copy to llm button to Starlight or Astro at the top of Table of Contents.
@wave-rf/starlight-llm-tools - Starlight plugin that adds LLM-friendly tooling to your docs site: per-page .md twins with navigation headers, llms.txt / llms-full.txt / llms-small.txt routes, and Copy-Markdown + Open-with-AI buttons in the page header. Optional transform pipeline pla
starlight-llms-txt - Add llms.txt to your documentation site based on llmstxt.org.
starlight-llms-txt - Generate llms.txt files to train large language models on your Starlight documentation website
@hey-api/starlight-llms-txt - Generate llms.txt files to train large language models on your Starlight documentation website
@f5-sales-demo/starlight-llms-txt - Generate llms.txt files to train large language models on your Starlight documentation website
@rttnd/starlight-llms-txt - Generate llms.txt files to train large language models on your Starlight documentation website
starlight-markdown-blocks - Extend Starlight’s Markdown asides syntax with custom block types.
@markgrafhq/starlight-markgraf - Starlight/Astro integration for embedding markgraf animations. Transforms ```markgraf fenced code blocks into a live player and exposes a component.
starlight-mcp - Give your Astro or Starlight docs site an MCP server — search_docs, get_doc and list_docs over stateless streamable HTTP. Astro integration, pure fetch handler, and Cloudflare static-assets glue included.
@mseep/starlight-mcp - Give your Astro or Starlight docs site an MCP server — search_docs, get_doc and list_docs over stateless streamable HTTP. Astro integration, pure fetch handler, and Cloudflare static-assets glue included.
starlight-md-txt - Expose your Starlight documentation pages as raw, agent-friendly Markdown at .md.txt URLs.
starlight-obsidian - Publish Obsidian vaults in your Starlight site.
starlight-openapi - Create documentation pages from OpenAPI/Swagger specifications.
starlight-package-managers - Quickly display npm related commands for multiple package managers.
starlight-page-actions - Adds page action buttons to your documentation.
starlight-page-context-action - Make utility actions like copy/view page as markdown, open in AI chat, and scroll to top always accessible in your docs.
starlight-plausible - Plausible plugin for Astro Starlight
@hideoo/starlight-plugin - A generator to quickly scaffold Starlight plugins.
starlight-plugin-icons - Add icons to Astro Starlight: sidebar, codeblocks, filetree.
@dagilleland/starlight-plugin-layouts - Starlight plugin that bundles all four Starlight Layouts packages and registers their component overrides automatically — no override files to create.
@hideoo/starlight-plugins-docs-components - Set of opinionated Starlight components used in HiDeoo's Starlight plugins documentations.
starlight-pydocs - Automated Python API docs for Astro and Starlight, using static analysis.
starlight-pydocs - Python API reference documentation for Astro and Starlight, extracted with Griffe.
starlight-quiz - Interactive quizzes for Astro and Starlight, authored in markdown with full progress tracking.
starlight-quiz - Interactive quizzes for Astro and Starlight, authored in markdown with full progress tracking.
starlight-recipes - Starlight plugin to create a recipe website.
starlight-recipes - Starlight plugin to create a recipe website.
starlight-rustdoc - Astro / Starlight integration that generates documentation pages from rustdoc JSON output.
starlight-save-file-component - Quickly display a link to some download asset on your Starlight site.
starlight-scroll-to-top - Add a scroll-to-top button to your documentation site.
starlight-showcases - Set of Starlight components to author showcase pages.
starlight-sidebar - A lightweight utility for building deeply nested, multilingual Starlight sidebars from a simple, declarative structure.
starlight-sidebar-swipe - Make the left sidebar swipeable on mobile devices like Discord Mobile.
starlight-sidebar-topics - Split your documentation into different sections, each with its own sidebar.
starlight-sidebar-topics-dropdown - Split your docs page into multiple subpages and switch between them with a dropdown menu in the sidebar.
starlight-site-graph - Add an interactive site graph inside your page’s sidebar.
starlight-skills - A Starlight plugin that turns your documentation into AI-installable skills
starlight-tags - Add tags to your Starlight documentation pages for content organization and discovery.
starlight-tags - A Starlight plugin for organizing docs with tags and auto-generated tag pages.
starlight-telescope - Quickly navigate to any page in your Starlight docs with fuzzy search and keyboard-first navigation.
starlight-telescope - Quickly navigate to any page in your Starlight docs with fuzzy search and keyboard-first navigation.
starlight-to-pdf - A CLI tool to convert Starlight websites into PDF files.
starlight-to-skills - Turn Starlight documentation pages into reviewed, discoverable, and up-to-date agent skills.
starlight-toc-overview-customizer - Tweak Starlight’s table of contents with customizable overview title.
starlight-typedoc - Generate Starlight pages from TypeScript using TypeDoc.
starlight-ui-tweaks - Extends core UI components with custom navigation links, ads, marketing footers, and a cleaner theme toggle.
starlight-versions - Version your Starlight documentation pages.
starlight-videos - Enhance your documentation with video guides and courses.
starlight-view-modes - Add different view mode capabilities to your documentation website.

Themes

Discover beautiful themes for your Starlight documentation:

Catppuccin for Starlight - Soothing pastel theme for Starlight.
Exquisitus - A Starlight theme that blends readability and beauty without compromising on either.
hc-starlight - Astro Starlight theme with Hack Club branding — for building beautiful docs and playgrounds
Ion - A sleek, modern theme for Starlight.
@nu-appdev/northwestern-starlight-theme - A Northwestern-branded theme for Astro Starlight
@lunariajs/starlight - Lunaria integration for the Starlight documentation theme for Astro
@grove-dev/starlight - Grove's theme for Starlight (the Astro native documentation site generator)
@nebari/starlight - Shared Starlight theme plugin for Nebari documentation sites.
Starlight Black - Starlight theme inspired by shadcn docs.
Starlight Celestia - A clean, modern theme with seamless sidebars and warm accents.
Starlight Flexoki - A warm and friendly theme based on the Flexoki color palette.
Starlight Galaxy - An Astro Starlight theme tailored for publishing documentation and educational content.
Starlight Gruvbox - Retro groove theme for Starlight
Starlight Lucode - A sharp, polished product-docs theme inspired by shadcn/ui.
Starlight MD3 - A Material Design 3 and Material You-inspired theme with dynamic color roles, tonal surfaces, state layers, and motion.
Starlight Next.js - Starlight theme inspired by the Next.js docs.
Starlight Nord - An arctic, north-bluish theme for Starlight, inspired by Nord Theme from Arctic Ice Studio
Starlight Nova - A modern and beautiful theme for Starlight.
Starlight Obsidian - Starlight theme inspired by the style of Obsidian Publish sites.
Starlight Page - An intuitive, modern Starlight theme with smooth, float-in animations.
Starlight Rapide - Starlight theme inspired by the Visual Studio Code Vitesse theme.
Starlight Rosé Pine - Soho vibes for Starlight.
Starlight Six - Clean and modern Astro.js Starlight theme by Six Technology
Starlight Terminal - A customized Astro Starlight theme combining modern and retro elements.
Starlight Vintage - Starlight theme heavily inspired by the timeless design of the legacy Astro documentation.
@astrojs/starlight-docsearch - Algolia DocSearch plugin for the Starlight documentation theme for Astro
@astrojs/starlight-markdoc - Markdoc preset for the Starlight documentation theme for Astro
@astrojs/starlight-tailwind - Tailwind CSS plugin for the Starlight documentation theme for Astro
@sentry/starlight-theme - Sentry's shared Astro Starlight theme.
@ozzylabs/starlight-theme - Shared Starlight docs theme
@openscript-ch/starlight-theme - Starlight theme of openscript Ltd.
@psa-department-of-engineering/starlight-theme - The shared Starlight look for every docs site: a warm dark palette override plus a token-based Mermaid contrast layer (stylesheet), and the matching astro-mermaid mermaidConfig. One source of truth, consumed via Starlight customCss + a config import.
@bogoware/starlight-theme - Bogoware brand identity theme for Astro Starlight documentation sites
@abstractdata/starlight-theme - Abstract Data Documentation Theme — the branded docs system Abstract Data uses across client projects. Built on Astro Starlight. HUD and Calm surfaces, light + dark, motion-aware. Ships with the abstract-data-setup skill (Claude Code, Cursor, GitHub Copil
starlight-theme-dracula - A dark theme for Astro Starlight
starlight-theme-mdbook - Starlight theme that looks and feels like rust-lang's mdBook — layout, chrome, and 4 built-in color schemes plus 2 bonus daisyUI-ported themes.
@multitheftauto/starlight-theme-mtasa - Starlight theme for Multi Theft Auto

Tools

Development tools and utilities for Starlight:

astro-starlight-docs-template - CLI tool to add Google Analytics, GDPR cookie consent, SEO, and LLM optimization to Astro Starlight documentation sites
@ratiu5/starlight-search-cli - Starlight search CLI

Showcases

Real-world documentation sites built with Starlight:

Videos

Video tutorials and screencasts:

🌟 SUB 1 MINUTE RUN - Watch Ben launch a new Starlight site in under a minute!
Astro Starlight - Introduction to Starlight in under a minute.
Astro Starlight and emoji-blast with Chris Swithinbank - Wherein Chris, the creator of Astro
Astro Starlight Documentation Template (build custom app docs!) - Get a new Starlight site up and running in about 5 minutes
Building docs with Starlight and Astro - Watch Chris and Alex dive into Starlight on Code with CodingCat.dev
Include Starlight docs in a Next.js project with proxies - Set up Starlight as a sub-directory project inside a Next.js website
One year of Starlight! - Sarah talks about Astro
Starlight by Astro - Watch the official Starlight launch video

Articles & Case Studies

Add a reading progress indicator - Find out how to add a horizontal reading progress bar to your Starlight site.
Add a sitewide banner to Starlight - Learn how to create a sitewide banner using Starlight
Add diagrams to your Starlight documentation using D2 - Learn how to use D2 to add diagrams to your Starlight documentation.
Add links to Starlight headings - A guide to using a rehype plugin to share links to specific sections of your documentation.
Add Open Graph images to Starlight - A guide to generating social images and the corresponding meta tags for your pages.
Add social links with custom icons to Starlight - Learn how to use custom icons for social links in Starlight website header.
Add sponsors to your Starlight site - A guide to implement a custom sponsors component in your documentation sidebar.
Adding Structured Data to Starlight Pages - Learn how to build dynamic JSON-LD structured data for your documentation pages.
Apply custom styles to your Starlight sidebar - Using a little bit of CSS to adjust fonts, colours and more of the Starlight sidebar.
Building a documentation site using Astro Starlight - Maciek Palmowski describes how Patchstack migrated their documentation to Starlight
Case Study: Slashing Development Costs - How WP Engine Lowered Development Costs by Over 50% with Astro’s Starlight.
Collect user feedback with Encatch - Add in-page reader feedback, suggested edits, and issue reports to your Starlight docs.
Comparing docs site builders: VuePress vs Starlight - How do these two frameworks measure up?
Contributing to Starlight - My personal experience and suggestions for contributing to open-source projects like Starlight.
Customizing Astro Starlight Sidebar for Gated Content with Authentication - Secure your course material by using Clerk and SSR to dynamically hide or reveal Starlight sidebar chapters based on user login.
Edit the HTML head of Starlight pages - Learn how to add common head content such as web analytics, fonts, and scripts.
Enable View Transitions - Add support for view transitions, client-side routing, and SPA-like navigation to your Starlight documentation site.
FeelBack - Add a user feedback system to your docs pages.
Generate Open Graph images for Starlight using the Cloudinary Astro SDK - Learn how to use the Cloudinary Astro SDK to generate Open Graph images for your Starlight documentation website.
Hybrid Frontend Architecture with Astro and Starlight - Maxi Ferreira and Ben Holmes build a docs site with Starlight, TinaCMS, and an interactive API Playground with authentication.
List recent GitHub releases in Starlight using the Astro Content Layer API - Learn how to use the Astro Content Layer API to list the recent GitHub releases in a Starlight project.
Open source all the way down - How Cloudflare used Starlight to upgrade their developer documentation.
Paste images to Starlight pages with Visual Studio Code - Improve your Starlight documentation workflow by pasting images to your documentation pages using Visual Studio Code.
Processing Starlight sidebars with middleware - Use route middleware to control sidebar ordering and group labels, inspired by Nuxt Content’s conventions.
Publishing Documentation with Astro Starlight - Getting started with Starlight documentation.
Starlight Changelog - View all releases of the @astrojs/starlight package on a single beautiful page.
Starlight Examples - A collection of StackBlitz embeds demonstrating practical ways of doing stuff in Starlight documentation sites.
Starlight Plugins by Example - A collection of notes and examples about Starlight plugins and common patterns used to build them.
Starlight Topics Dropdown on mobile, List on desktop - Combine two plugins to have the best of both on desktop and mobile devices.
Static Site Generation with Starlight - “No idea is too big or too small when designing components” — an interview with Chris Swithinbank, Starlight Lead
Use third-party icon sets in Starlight - A guide to using unplugin-icons to expand the selection of available icons for Starlight.
Versioned documentation with Starlight & Vercel - A guide to implementing separate versions of documentation for each major version of a project.

Community

Official Channels

Astro Discord - Join the Astro community on Discord.
GitHub Discussions - Ask questions and share ideas.
Twitter/X - Follow Astro on Twitter/X.

Community Content

Starlight Tips & Tricks - Community tutorials and tips.
Astro Blog - Official Astro blog with Starlight updates.

Contributing

Contributions are welcome! If you have a plugin, theme, or resource to add:

For automated sections (Plugins, Themes, Tools, Showcases, Videos, Articles): These are automatically discovered and updated. Make sure your project:
- Is published on NPM with starlight in the name or keywords (for plugins/tools)
- Is listed in the official Starlight documentation
- Appears in the Astro showcase with Starlight integration
For manual sections (Official Resources, Tutorials, Community): Open a pull request with your addition.

Please read the Awesome List guidelines first.

License

See LICENSE for more information.

Last automated update: Check the commit history

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
scripts		scripts
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml

Navigation Menu

Uh oh!

Uh oh!

Repository files navigation

Awesome Starlight

Contents

Official Resources

Tutorials & Guides

Getting Started

Deployment

Customization

Plugins & Integrations

Themes

Tools

Showcases

Videos

Articles & Case Studies

Community

Official Channels

Community Content

Contributing

License

About

Releases

Sponsor this project

Packages

Contributors

Languages

Uh oh!

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Awesome Starlight

Contents

Official Resources

Tutorials & Guides

Getting Started

Deployment

Customization

Plugins & Integrations

Themes

Tools

Showcases

Videos

Articles & Case Studies

Community

Official Channels

Community Content

Contributing

License

About

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages