Skip to content
Grav 2.0 is officially stable. Read the announcement →
Premium / Helios Theme
Premium Theme · v2.1.16

Helios Theme

Modern documentation theme for Grav

A modern, feature-rich documentation theme for Grav CMS built on the latest Tailwind CSS 4 framework and Alpine.js. Helios provides a beautiful three-column layout with sidebar navigation, content area, and on-page table of contents - perfect for both developer documentation and product guides.

Grav 1.7+

Now available with Ready-to-Run prebuilt Grav install zips with Helios theme, sample skeleton package content, all plugins and licenses ready to go. Just unzip and go! Find the download links alongside your licenses in the license manager.

Helios theme also includes a complimentary license to SVG Icons plugin.

Everything you need. Nothing you don’t.

Over 36 distinct features and integrations, out of the box.

01
Built on the latest Tailwind CSS 4 framework with modern best practices
02
Responsive three-column layout with configurable widths
03
Alpine.js powered interactivity for smooth UX
04
Full Dark & Light mode support with system preference detection
05
5 color presets (Default, Ocean, Forest, Sunset, Midnight) plus custom colors
06
8 font choices including Inter, Open Sans, Nunito Sans, and more
07
Configurable font sizing options (small, medium, large)
08
Folder-based versioning with automatic detection and smart switching
09
Built-in SimpleSearch integration with Cmd+K keyboard shortcut
10
YetiSearch Pro ready for advanced fuzzy search capabilities
11
200+ language syntax highlighting via Codesh plugin
12
70+ code themes including GitHub, Dracula, Nord, One Dark Pro
13
Code blocks with line numbers, highlighting, focus mode, and diffs
14
Synced code groups for multi-file examples
15
GitHub-style callout boxes (Note, Tip, Important, Warning, Caution)
16
Cards & grids for flexible content layouts
17
Buttons with color variants, sizes, icons, and bordered/plain styles
18
Badges for inline status pills with color variants and outline styles
19
Synced tabs for OS or language selectors
20
Steps component for tutorials and guides
21
File tree component with auto-detected icons
22
Link cards for external resource previews and further reading
23
Details collapsible sections for toggleable content
24
Tooltips for hover definitions on inline terms
25
Keyboard keys with styled <kbd> elements and Mac symbol support (⌘, ⌥, ⇧)
26
Copy text for inline one-click clipboard copying
27
Images with border, shadow, caption, and lightbox zoom
28
Videos with responsive embeds for YouTube, Vimeo, and local files
29
30,000+ icons from Tabler, Heroicons, Bootstrap, Lucide, and more
30
API documentation templates with method badges, parameter tables, and grouped API collections that render multiple endpoints on a single page with quick-jump TOC
31
Scroll-spy TOC with active section highlighting
32
Breadcrumb navigation with configurable separators
33
Optional HTMX navigation for SPA-like experience
34
GitHub integration for edit links
35
Prev/Next navigation between pages
36
Fully mobile responsive with collapsible navigation
Three-Column Documentation Layout

Three-Column Documentation Layout

Helios features a professional three-column layout designed specifically for documentation. The left sidebar provides hierarchical navigation through your content, the center column displays your beautifully formatted content, and the right sidebar shows a scroll-spy table of contents that highlights the current section as you read. All column widths are fully configurable.

Dark & Light Mode

Full support for light and dark themes with automatic system preference detection. Users can manually toggle their preference, and their choice is remembered across sessions. The theme also includes 5 color presets (Default, Ocean, Forest, Sunset, Midnight) or you can define your own custom brand colors.

Dark & Light Mode
Powerful Code Blocks

Powerful Code Blocks

Powered by the Codesh plugin, Helios provides exceptional code presentation with syntax highlighting for 200+ languages, 70+ themes, line numbers, line highlighting, focus mode, and diff visualization. Create synced code groups for multi-file examples that stay synchronized across your entire documentation.

Documentation Components

A rich set of components designed for technical documentation including GitHub-style callout boxes, cards and grids, link cards, buttons and badges, synced tabs, numbered steps, file trees, collapsible details and accordions, tooltips, styled keyboard keys with Mac symbol support, inline copy text with clipboard buttons, images with lightbox zoom, responsive video embeds, and access to 30,000+ icons from popular icon libraries.

Documentation Components
Version Management

Version Management

Built-in support for folder-based versioning allows you to organize documentation by version (v1/, v2/, v3/). The version dropdown automatically detects your versions and preserves URLs when users switch between them - perfect for software projects with multiple releases.

Search Integration

Out-of-the-box integration with SimpleSearch provides real-time full-text search with keyboard shortcuts (Cmd+K / Ctrl+K). For larger documentation sites, Helios is YetiSearch Pro ready, offering advanced fuzzy matching, chunked indexing, and relevance scoring.

Search Integration

A peek at sites running Helios Theme.

Frequently Asked Questions

The most commonly asked questions about the Helios Grav theme

What is Helios designed for?

Helios is specifically designed for documentation websites. It works great for:

  • Developer documentation (API references, SDK guides)
  • Product documentation (user guides, how-tos)
  • Knowledge bases and help centers
  • Technical wikis and internal docs
Can I use Helios theme on multiple sites?

Per the Grav Premium License, you need to have a license for each use.

Can I extend or customize Helios?

Absolutely! Helios is built with customization in mind. You can override colors via CSS variables, choose from preset themes, select different fonts and sizes, and extend the theme with your own templates. You will still need a dedicated Helios license for each site.

Does Helios work with existing Grav plugins?

Yes! Helios integrates seamlessly with the Grav ecosystem. It has built-in support for SimpleSearch, YetiSearch Pro, Shortcode Core, *Github Markdown Alerts, and SVG Icons** plugins. It also works with standard Grav plugins like Page Inject, Pagination, and more.

How does versioning work in Helios?

Helios supports folder-based versioning. Simply organize your documentation in version folders (v1/, v2/, v3/) and Helios automatically detects them. A version dropdown appears in the sidebar, and when users switch versions, the URL path is preserved to navigate to the equivalent page in the selected version.

What search options are available?

Helios includes two search options:

  • SimpleSearch - Built-in real-time search with keyboard shortcuts
  • YetiSearch Pro - Advanced fuzzy search with chunked indexing for larger sites

Both options support the Cmd+K / Ctrl+K keyboard shortcut to quickly open search.

$50 Buy Now

Helios Theme Changelog

v2.1.16

2 weeks ago

    • The file tree shortcode keeps its line breaks and indentation when you switch to Editor Pro and back, instead of being flattened onto one line (getgrav/grav-premium-issues#614).

v2.1.15

1 month ago

    • Fixed the PHP debug bar not rendering (and its "PhpDebugBar is not defined" console error) by outputting the default head JS asset group, which core and plugins use and the theme was previously dropping

v2.1.14

1 month ago

    • The login, registration, and profile pages now render inside the theme layout instead of showing just a heading with no form

v2.1.13

2 months ago

    • Added a tailwind4: contract to the theme config, so the Tailwind4 plugin can compile the theme's CSS from PHP with no Node/npm toolchain. The npm build scripts still work; both produce the same output

v2.1.12

2 months ago

    • Fixed the documentation version (sidebar navigation and version badge) being misdetected on any page that is the configured system.home.alias. Grav collapses such a page's route() to /, which hid the version prefix and forced a fall-through to default_version — so with a non-default default_version, pages under another version rendered the default version's navigation and badge. Version detection now reads rawRoute(), which always carries the real /<version>/... path

v2.1.11

2 months ago

    • Fixed wide tables no longer scrolling horizontally on narrow screens/mobile. Content tables are now their own horizontal scroll container (display:block with overflow-x:auto), so oversized tables scroll instead of squishing while narrow tables still fill the full content width #599

v2.1.10

2 months ago

    • Fixed the [doc-image] lightbox opening the raw image file instead of the zoom overlay. The 2.1.9 fix for #598 added a capture-phase click guard that stopped propagation on any link to a media file, which fired before the lightbox link's own bubble-phase handler could preventDefault(). The guard now leaves hx-boost="false" links (including the lightbox link) alone, since HTMX never boosts them anyway #598

v2.1.9

2 months ago

    • Fixed HTMX navigation hijacking links to media files, so clicking a local PDF or other attachment now opens it in the browser instead of dumping its contents into the page #598

v2.1.8

2 months ago

    • Hardened HTMX back/forward navigation against browser-specific history failures (notably Brave, where Shields can partition or clear localStorage and leave htmx's history snapshot cache empty). Set htmx-config refreshOnHistoryMiss: true so a history cache miss falls back to a full page reload instead of a silent AJAX swap that could update the URL without updating the content #594

v2.1.7

2 months ago

    • Fixed the back/forward button losing the page chrome (sidebar, header, TOC) during HTMX-boosted navigation. On a history cache miss htmx re-fetches the URL and replaces the whole <body>, but the theme only checked for the HX-Request header and returned the chrome-less content partial. It now excludes history-restore requests (HX-History-Restore-Request) so the back button receives the full page. Also added Vary: HX-Request, HX-History-Restore-Request so Grav's long Cache-Control can't let a cached partial poison a later full navigation