For AI agents: The complete documentation index is available at /llms.txt. A markdown version of this page is available at /index.md.
EditMD
Edit on GitHubView Markdown
The Better Static Sites mascot, Sean the shnek

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.

Tabs

v1.0.0—component

Zero-JavaScript tabbed content panels with CSS custom property theming.

Cards

v1.0.1—component

Link cards, child-page grids, and prev/next page navigation.

Tables

v0.1.1—component

RST-style list-table and grid-table components for structured data.

Admonitions

v0.1.1—component

Extensible callout boxes and inline badges for Astro MDX.

Collapsible Content

v0.1.0—component

Native details/summary disclosure panels with animated chevron and CSS custom property theming.

Declarative Screenshots

v0.4.1—componenttool

Declarative, Docker-backed screenshots for Astro docs. Define screenshots in MDX; generate PNGs on demand and commit them.

Layout

Navigation Sidebar

v1.0.0—component

Auto-building docs sidebar from a content collection, with tree expansion and active-page tracking.

Table of Contents

v1.1.0—integrationcomponent

Server-side table of contents with scroll spy and optional inline mobile accordion, injected at build time.

Top Nav/Menu Bar

v0.1.1—component

Configurable top navigation bar with dropdowns, theme selector, search, login link, and CTA button.

Release Notes

v0.1.1—component

Versioned changelogs with category filtering and version dropdown navigation.

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.

Code Snippet Extraction

v0.2.1—integrationcomponent

Load Bluehawk-annotated code snippets and local source files into Astro pages.

Mermaid Diagram Renderer

v0.1.0—integration

Server-side Mermaid diagram rendering to inline SVG at build time.

Anchor References

v0.1.0—integrationcomponent

Sphinx-style named anchors that survive content moves.

Markdown Page Generation

v1.0.0—integrationcomponent

Generates .md companion files and llms.txt from built HTML pages at build time.

Link Checker

v1.0.0—integration

Fast intra-site broken link and image checker that deduplicates destinations.