Helios Documentation Theme
A modern, feature-rich documentation theme for Grav CMS built on Tailwind CSS 4 and Alpine.js.
Install and configure Helios in minutes with our step-by-step guide.
Discover callouts, cards, tabs, code blocks, and more.
Core Features
Sidebar navigation, content area, and on-page table of contents with configurable widths.
System preference detection with manual toggle. Remembers user choice.
Optimized for desktop, tablet, and mobile with collapsible navigation.
Appearance & Theming
Default, Ocean, Forest, Sunset, and Midnight — or define your own custom colors.
Inter, Open Sans, Nunito Sans, Work Sans, Public Sans, Ubuntu, Poppins, Quicksand.
Small, medium, or large font sizes. Adjustable sidebar, content, and TOC widths.
Search
Built-in real-time full-text search with keyboard shortcuts (Cmd+K / Ctrl+K).
Advanced fuzzy matching, chunked indexing, and relevance scoring for larger sites.
Code Blocks
Powered by the Codesh plugin with server-side syntax highlighting.
JavaScript, Python, PHP, Ruby, Go, Rust, SQL, YAML, and many more.
GitHub, Dracula, Nord, One Dark Pro, Tokyo Night, Catppuccin, and more.
Line numbers, highlighting, focus mode, and diff visualization.
Synced tabs for multi-file examples that stay in sync across the page.
Show file context in the header with optional language badges.
Automatically adapts to light or dark mode.
Documentation Components
Note, Tip, Important, Warning, and Caution alerts using GitHub syntax.
Flexible card layouts with icons and links in responsive grids.
Persistent tab selection across pages — perfect for OS or language selectors.
Numbered task lists with visual timeline for tutorials and guides.
Auto-detected icons, CLI tree format support, and symlink display.
Tabler, Heroicons, Bootstrap, Lucide, and more icon sets available.
API Documentation
Method badges (GET, POST, PUT, DELETE), endpoint paths, and parameter tables.
JSON-formatted examples with syntax highlighting and response code documentation.
Versioning
Organize docs by version (v1/, v2/, v3/) with automatic detection or manual configuration.
Version dropdown in sidebar with URL preservation when switching between versions.
Navigation & Structure
Generated from folder hierarchy with numeric ordering and collapsible sections.
Right-side table of contents with active section highlighting as you scroll.
Full navigation path display with configurable separators.
Additional Features
Edit links to your repository with customizable text and branch settings.
Optional SPA-like experience with XHR content loading.
Navigate between pages at the bottom of each content area.
Quick Start
# Install the theme
bin/gpm install helios
# Set as active theme
bin/grav theme helios
Or manually download and extract to your user/themes/helios folder.
Support
Need help? Check out these resources: