Content & Documentation

Starlight Documentation

Build beautiful documentation sites with Astro Starlight theme featuring i18n, search, and sidebar navigation.

Claude Code Cursor Copilot Windsurf

Overview

Starlight is Astro's official documentation theme, providing a complete documentation site with built-in search, i18n, accessibility, and beautiful design out of the box. AI coding agents can create documentation pages, configure navigation, and customize the theme.

Agents can generate Markdown/MDX documentation pages with Starlight's component library including tabs, cards, aside callouts, and code blocks. They can configure the astro.config.mjs for sidebar structure, localization settings, and custom CSS.

Starlight supports automatic table of contents, OpenAPI integration, and SEO optimization. Teams can use AI agents to rapidly scaffold documentation sites that meet accessibility standards and provide an excellent reading experience across devices and languages.

Who Is This For?

Scaffold Starlight documentation site with i18n support
Generate documentation pages with Starlight components
Configure sidebar navigation and page ordering
Set up multilingual documentation with automatic routing

Installation

Setup for Claude Code

npm create astro@latest -- --template starlight

Configuration

// astro.config.mjs
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

export default defineConfig({
  integrations: [
    starlight({
      title: 'My Docs',
      defaultLocale: 'en',
      locales: { en: { label: 'English' }, ar: { label: 'العربية', dir: 'rtl' } },
      sidebar: [
        { label: 'Guides', items: [
          { label: 'Getting Started', slug: 'guides/getting-started' },
        ]},
      ],
    }),
  ],
});