just-the-docs/just-the-docs
Just The Docs
Just the Docs is a Jekyll theme designed for building documentation sites that are hosted on GitHub Pages. It provides a responsive, mobile-friendly layout with built-in search, hierarchical navigation, and extensive customization through overridable SCSS variables, Liquid includes, and page layouts.
The theme distinguishes itself through a file-based navigation hierarchy that automatically generates multi-level collapsible menus from directory structures and front matter, combined with client-side full-text search that indexes page content at build time. It includes automated deployment via GitHub Actions, supports light and dark color schemes, and offers granular control over page ordering, breadcrumb trails, child page lists, and table of contents generation from headings.
Additional capabilities include custom page headers and footers, auxiliary external links, back-to-top links, minimal layouts without sidebars, and the ability to exclude specific pages or collections from navigation or search results. The theme also supports named collections for organizing content into separate navigation sections and provides fallback navigation guidance for missing pages.