Starlight is a production-grade documentation framework built as an Astro integration. It transforms Markdown/MDX content collections into fully-featured documentation sites with i18n, sidebar navigation, table of contents, search (Pagefind or DocSearch), expressive code blocks, and a rich component library (aside, badge, card, tabs, file tree, steps, etc.). The architecture follows a plugin system with lifecycle hooks (`config:setup`, `i18n:setup`) and supports component overrides via virtual modules, allowing deep customization without forking. The core package (`@astrojs/starlight`) handles route generation, Markdown processing (via unified or the custom Sätteri engine), CSS layer management, and head tag optimization. Official plugins add Tailwind CSS support, Algolia DocSearch, and a Markdoc preset. The codebase emphasizes accessibility, performance (minimal client JS, CSS cascade layers), and internationalization with 30+ translation files for UI strings and content fallback per locale. A comprehensive test suite (Vitest unit tests, Playwright e2e, accessibility audits) and automated CI/CD (changesets, preview releases) maintain reliability.
Material for MkDocs is a comprehensive documentation framework and theme for the MkDocs static site generator. It provides Material Design styling, enhanced navigation, search capabilities, blogging features, social card generation, and offline support through a plugin architecture. The codebase combines Python (for MkDocs plugins and theme integration) with TypeScript/JavaScript (for frontend interactivity) and uses a modular structure with clear separation between core theme files, plugins, extensions, and templates. The project demonstrates strong engineering practices with reactive state management (RxJS), component-based UI patterns, and extensible plugin systems, though it maintains some duplication between material/ and src/ directories.