just-the-docs/just-the-docs

Health v2 · maintenance only

Adoption not part of the score

9140 stars · 3789 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Just the Docs is a modern, highly customizable, responsive Jekyll theme designed for building documentation websites, with built-in client-side search. It is distributed as a Ruby gem and can be easily hosted on GitHub Pages with minimal dependencies.

Use cases

• create a documentation website for an open-source project
• host project docs on GitHub Pages
• build a static docs site with built-in search
• generate a responsive documentation site from Markdown files
• customize a Jekyll theme for a knowledge base
• add a navigation sidebar and search to a Jekyll site

When to choose

• you want a documentation site hosted for free on GitHub Pages
• you write docs in Markdown and want minimal tooling and dependencies
• you need built-in search, navigation sidebar, and heading anchors out of the box
• you want a highly customizable SCSS-based theme with light/dark color schemes

When to avoid

• you need a dynamic, server-rendered application rather than a static site
• your stack is not Ruby/Jekyll-based (e.g., you prefer Node-based static site generators)
• you need advanced full-text search features like faceting or analytics beyond client-side search
• you want a general-purpose blog or marketing site theme rather than docs-focused layout

Facets

plugin · maturity active

static-site-generator search-engine ui-components templating documentation documentation web-development frontend ruby self-hosted jekyll-theme github-pages static-site docs-theme scss mermaid-diagrams responsive-design web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="just-the-docs/just-the-docs")