Skip to content
● Meet Grav Guard: keep every Grav site you run secure and up to date, all from one place. Free for up to 3 sites. Read more →
Premium / Helios Theme
Premium Theme · v2.2.4

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+
Live Demo Documentation

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 your account.

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.

Helios Theme Changelog

v2.2.4

1 week ago

    • Works with a catalog store. With the cart off, the theme draws no cart link, basket count or Add to cart, shows KahunaCart's enquiry button where the buy button was, leaves prices out when the store hides them, and styles the new Sort by control. Helios still doesn't need KahunaCart: without it, or with a KahunaCart older than 1.6.21, the theme checks for the cart and hidden prices itself (helios_cart_enabled(), helios_prices_shown()) and carries on as before

v2.2.3

2 weeks ago

    • /sitemap.xml and /llms.txt work again. Helios 2.2.1's check for pages whose plugins are missing asked the sitemap event for a reference it can't hand out, which threw an error and broke both files. It also finds each page by its own route now, so the check works on a multi-language site, where the sitemap's URLs start with a language prefix

v2.2.2

2 weeks ago

    • The checkout's Create an account box no longer shows unticked for a moment. A guest buying a membership needs an account, so Helios ticks the box and keeps it ticked; it did that once the whole page had loaded, so the box could be seen unticked first. It is ticked now as soon as it is on the page

v2.2.1

2 weeks ago

    • Courses in Helios's own look: the course page now sits in the docs frame with the course sidebar, and the course page, the sidebar, the lesson meta line, the video, practice files, Mark as done, the lesson's previous and next links, Up next, the locked-lesson extras and the plans module are all drawn with the same type, colors, borders and cards as doc pages, light and dark. The course page also prints its own text now
    • A page can name the plugins it needs with requires_plugins: [kahunacart, kahunacart-subscriptions]. Where one is missing or off, the page and everything under it is a 404 and is left out of the sidebar, the previous and next links, the sitemap, search and the header menu
    • Course features switch on by themselves when a page uses the course template, so the courses.enabled setting is gone. Courses have their own tab in the theme settings
    • Removed: the marketing modules and the Darkroom look from 2.2.0 have moved to the new Shutterhouse theme: the courses, lesson_peek, team, instructors, gallery, quotes, features, steps, faq, page_head and cta modules with their blueprints, css/helios-site.css and its --hs-* tokens, the header's Join and Sign in (header.cta) and phone menu, the header laid over a photo (header_over), the footer's call to action and link columns (footer.*), and the page and card background settings (appearance.page_bg, card_bg and their dark twins). A 2.2.0 site that uses them should move to the Shutterhouse theme, or rewrite those sections as plain pages. Pages using them still render, without the removed parts
    • Removed: the course page's photo hero, instructor card and quote, the hero module's photo keys (focus, mirror, credit, lesson), the facts module's worked-out figures (count, note) and courses.instructors_route. A course's instructor is now a plain name
    • The KahunaCart starter-store modules (hero, facts, categories, products, intro) are drawn with Helios's own Tailwind utilities instead of a separate stylesheet. A hero can show an image beside its words when it has no products
    • plans draws the plans side by side as cards, for any billing interval, with ticks under them for what every plan includes
    • KahunaCart's paywall panel shows a lock beside its heading and each plan's amount in bold on every Helios site, and a course with no locked lessons no longer offers a membership
    • appearance.custom_css moved to the Advanced tab
    • Helios runs on PHP 7.3 and 7.4 again: 2.2.0 still used mixed type hints, which PHP before 8.0 reads as a class name, so every page failed there even though the files lint
    • A long page title in the phone header is cut short with an ellipsis instead of running under the search button, which the KahunaCart cart and account buttons made likely
    • A modular page that uses a module type Helios doesn't have draws nothing for visitors and a short note for signed-in editors, instead of a Twig error

v2.2.0

2 weeks ago

    • KahunaCart store support: with the KahunaCart plugin on, the shop, products (including Subscriptions plans), cart, checkout, receipts, the customer account and paywalled lessons are drawn in Helios's own frame and colors, light and dark, with a cart and account button in the header. Store pages always load in full rather than through HTMX. Sites without KahunaCart are unchanged
    • Course sites, all off until a site turns them on in the new Course site tab, so docs sites are unchanged: a course page template (hero, what you'll learn and need, the lessons by chapter with Free and lock marks, the instructor and a side card with the membership's prices), a sidebar for each course with chapters and numbered lessons, a lesson meta line, a video block, practice files, Mark as done with ticks kept in the browser, the course's previous and next lessons and an Up next box. See Course sites in the README
    • Modular pages with fourteen module types (hero, facts, courses, lesson_peek, plans, team, instructors, gallery, quotes, features, steps, faq, page_head, cta), each with a blueprint, editable in the admin, drawing nothing when empty and saying so when the plugin it needs is missing or off
    • The membership panel under a locked lesson can send every Join to a membership page (courses.membership_route), and adds the lesson's meta line, a link to the course's free lesson and an outline of what's in the rest. The plans module posts a plan straight to checkout, and a guest buying a membership gets an account made for them
    • Join and Sign in in both headers with a menu button on phones (header.cta), a header laid over a page's first photo (header_over: true), and a footer with a call to action and link columns (footer.cta, footer.columns)
    • Page and card background settings (appearance.page_bg, card_bg and their dark twins) and a stylesheet of your own loaded last (appearance.custom_css)
    • [doc-callout] draws Helios's callouts from page content, and [div class="table settings"] styles a settings table
    • Store cards say Add to cart when they can add the product straight away, Choose or Book when there's something to pick, and show the low-stock count
    • Checkout lists what's being bought above the totals
    • A store home built from KahunaCart's starter content renders in Helios: new categories, products and intro modules, a hero that also takes cta, cta2 and a row of products (beside the words without a photo, under it with one) and allows an <em> in its title, and facts that draws items with a title and text as cards. Shutterhouse's hero and facts draw as before
    • Default and contact pages leave out their title when the page's content already has its own top heading, so a page written as # About no longer shows "About" twice
    • Helios loads on PHP 7.3 again, which Grav 1.7 still allows: [doc-tooltip] and the theme's own PHP no longer use syntax that needs PHP 7.4
    • [doc-image] finds a picture beside the page that holds it when that page's content is drawn somewhere else, such as a lesson's opening shown on the home page

v2.1.22

3 weeks ago

    • A table wrapped in [div class="table"] stays inside the content column and scrolls sideways when it's too wide, instead of running out under the page's table of contents learn#1165

v2.1.21

3 weeks ago

    • Tabs no longer show a small vertical scrollbar next to the tab titles on Windows and Linux

v2.1.20

4 weeks ago

    • The shadow option on [doc-image] now works: images only get a shadow with shadow=true, as the docs describe, and in light mode shadow=true gets the larger shadow it was meant to have (getgrav/grav-premium-issues#629)

v2.1.19

1 month ago

    • Search results can no longer inject markup into the search modal. YetiSearch highlights escape nothing and page titles are stored as typed, so a page titled <img src=x onerror=...> ran its script when it showed up in a search. Every < that does not start <mark> or </mark> is now turned into &lt;, for YetiSearch Pro and SimpleSearch results alike, and a highlight is never placed inside markup. Entities in your page text, such as &lt;code&gt;, still read as written

v2.1.18

1 month ago

    • German and French translations of the theme's text
    • On a site with more than one language, the breadcrumb Home link, the version switcher and version redirects stay in the language you are reading instead of jumping to the default one, and the Home crumb is translated
    • The version switcher knows which version you are on when you are on that version's home page