Just the Docs

Just the Docs has established itself as the go-to Jekyll documentation theme for open source projects, internal wikis, and API references. Its combination of powerful navigation, fast built-in search, and thoughtful typography has made it the choice of thousands of projects that need their documentation to be as good as their code.

The navigation system is the theme’s strongest feature. Pages are organised into a hierarchical tree — child pages nest under parents, sections collapse and expand, and the current page is always clearly highlighted. You control the order and nesting entirely through front matter properties in your Markdown files, with no separate configuration file required. Adding a new page to the docs is as simple as creating a file and setting parent: to the name of its section.

Search is built in via Lunr.js and works without any external service or API key. The search index is generated at build time and cached in the browser, so searches return results instantly with no network request. Results include the page title, section heading, and a content preview, making it easy to find exactly what you need across large documentation sites.

The theme supports both light and dark colour schemes, and each scheme is individually customisable through Sass variables. The default colour palette is professional and accessible, with enough contrast to pass WCAG AA guidelines out of the box.

Who is it for? Open source maintainers, developer advocates, and teams who need a clean, professional documentation site that deploys to GitHub Pages with zero configuration.