Installation
There are several ways to install the Helios theme for Grav.
GPM Installation (Preferred)
The simplest way to install this theme is via the Grav Package Manager (GPM) through your system's terminal:
BASH
bin/gpm install helios
This will install the Helios theme into your /user/themes/helios directory.
Manual Installation
To install this theme manually:
- Download the zip version of this repository
- Unzip it under
/your/site/grav/user/themes - Rename the folder to
helios
You should now have all the theme files under:
TXT
/your/site/grav/user/themes/helios
Required Plugins
Helios works best with the following plugins:
| Plugin | Required | Description |
|---|---|---|
| SimpleSearch | Yes | Powers the search functionality |
| Shortcode Core | Recommended | Enables shortcode syntax for callouts and tabs |
| SVG Icons | Recommended | Provides icon support throughout the theme |
| Codesh | Recommended | Server-side syntax highlighting with 200+ languages and VS Code themes |
| Page TOC | Recommended | Generates table of contents from headings |
| API Doc Import | Optional | Import OpenAPI/Swagger specs as API documentation pages |
Install the recommended plugins via GPM:
BASH
bin/gpm install simplesearch shortcode-core svg-icons codesh page-toc
For API documentation features, also install:
BASH
bin/gpm install api-doc-import
Skeleton Installation
For a complete demo installation, you can use the Helios Skeleton:
BASH
# Download and extract the skeleton
wget https://getgrav.org/download/skeletons/helios-site/latest
unzip helios-site-*.zip -d my-docs-site
This gives you a ready-to-use documentation site with example content.
Next Steps
Once installed, proceed to Configuration to customize your theme.