# Overview

Documentation for the astro-better-* family of Astro integrations and components.

> For the index of this section of the site, see [llms.txt](https://better-static-sites.github.io/llms.txt)

![The Better Static Sites mascot, Sean the shnek](https://better-static-sites.github.io/android-chrome-192x192.png "The Better Static Sites mascot, Sean the shnek, goes bss")

# Better Static Sites

A standard library of common tools and components you might need to build a nice static site. Does this suite contain the *best* tools around? We can't answer that. But they're certainly *better* than something.

## Content

[Linked Steps v0.1.0—component Numbered step sequences with CSS counters and a connecting vertical line.](https://better-static-sites.github.io/content/steps.md)

[Tabs v1.0.0—component Zero-JavaScript tabbed content panels with CSS custom property theming.](https://better-static-sites.github.io/content/tabs.md)

[Cards v1.0.1—component Link cards, child-page grids, and prev/next page navigation.](https://better-static-sites.github.io/content/cards.md)

[Tables v0.1.1—component RST-style list-table and grid-table components for structured data.](https://better-static-sites.github.io/content/tables.md)

[Admonitions v0.1.1—component Extensible callout boxes and inline badges for Astro MDX.](https://better-static-sites.github.io/content/admonitions.md)

[Collapsible Content v0.1.0—component Native details/summary disclosure panels with animated chevron and CSS custom property theming.](https://better-static-sites.github.io/content/details.md)

[Declarative Screenshots v0.4.1—componenttool Declarative, Docker-backed screenshots for Astro docs. Define screenshots in MDX; generate PNGs on demand and commit them.](https://better-static-sites.github.io/content/declarative-screenshots.md)

## Layout

[Navigation Sidebar v1.0.0—component Auto-building docs sidebar from a content collection, with tree expansion and active-page tracking.](https://better-static-sites.github.io/layout/docs-sidebar.md)

[Table of Contents v1.1.0—integrationcomponent Server-side table of contents with scroll spy and optional inline mobile accordion, injected at build time.](https://better-static-sites.github.io/layout/toc.md)

[Top Nav/Menu Bar v0.1.1—component Configurable top navigation bar with dropdowns, theme selector, search, login link, and CTA button.](https://better-static-sites.github.io/layout/nav-bar.md)

[Release Notes v0.1.1—component Versioned changelogs with category filtering and version dropdown navigation.](https://better-static-sites.github.io/layout/release-notes.md)

## Build Tools

[Code Snippets v0.1.2—integration Remark/rehype plugins for enhanced code blocks with copy button, line highlighting, diff mode, collapsible sections, file titles, and shell session formatting.](https://better-static-sites.github.io/build-tools/code-blocks.md)

[Code Snippet Extraction v0.2.1—integrationcomponent Load Bluehawk-annotated code snippets and local source files into Astro pages.](https://better-static-sites.github.io/build-tools/code-snippet-extractor.md)

[Mermaid Diagram Renderer v0.1.0—integration Server-side Mermaid diagram rendering to inline SVG at build time.](https://better-static-sites.github.io/build-tools/mermaid.md)

[Anchor References v0.1.0—integrationcomponent Sphinx-style named anchors that survive content moves.](https://better-static-sites.github.io/build-tools/refs.md)

[Markdown Page Generation v1.0.0—integrationcomponent Generates .md companion files and llms.txt from built HTML pages at build time.](https://better-static-sites.github.io/build-tools/gen-markdown-pages.md)

[Link Checker v1.0.0—integration Fast intra-site broken link and image checker that deduplicates destinations.](https://better-static-sites.github.io/build-tools/link-checker.md)