Repolode
Submit
ppoffice

ppoffice/hexo-theme-icarus

A simple, modern theme for the Hexo static site generator, with three visual variants and 50+ built-in plugins.

View on GitHubWebsite
Stars
6,633
Forks
1,520
Open issues
3
Last commit
12 days ago

What is it?

Icarus is a theme for Hexo, the Node.js static site generator. It gives blogs and personal sites a responsive layout with one to three columns, a navbar that folds sub-menus into a menu button on small screens, and a mobile table of contents. Users pick a variant in the config or in a post's front-matter: the default light/dark theme, a Cyberpunk dark style, or a Material 3 Expressive style.

Most features are switched on through the `_config.icarus.yml` file rather than code. The theme includes comment systems such as Giscus, Waline and Twikoo, search via Algolia or the built-in Insight search, sharing buttons, donation links, analytics, and widgets for profiles, tables of contents, and recent posts. Math is rendered with KaTeX or MathJax 4, and images can be shown in a lightGallery lightbox.

Navigation uses PJAX page loading and page prefetching on hover. In opt-in mode, analytics only load after visitors accept Cookie Consent. The theme supports translations into 17 languages.

Key features

  • 01Three visual variants: default light/dark, Cyberpunk, and Material 3 Expressive.
  • 02Responsive layout with one to three columns and an optional sticky navbar.
  • 03Built-in Insight search and integrations for Algolia, Baidu and Google CSE.
  • 04Comment systems including Giscus, Waline, Twikoo and Utterances.
  • 05KaTeX or MathJax 4 for math rendering, plus lightGallery image galleries.
  • 06PJAX navigation with page prefetching and a reading progress bar.

Use cases

  • Running a personal technical blog built with Hexo.
  • Publishing a static documentation or portfolio site with a clean look.
  • Adding comments, analytics and donation links to a Hexo site without custom code.
  • Creating a site that respects visitor privacy with opt-in cookie consent.

Quick start

  1. 1

    Install the theme and renderer in your Hexo site root

    npm install hexo-theme-icarus hexo-renderer-inferno
  2. 2

    Switch Hexo to the Icarus theme

    hexo config theme icarus
  3. 3

    Start the local server and preview the site

    hexo server

Things to know

  • Requires a Hexo site compatible with versions ^7.1.1 or ^8.0.0.

In collections

Static site generators & documentation tools

Topics

#hexo#hexo-theme#static-site#blog#javascript#responsive-design#markdown#theme

FAQ

What is hexo-theme-icarus?
A simple, modern theme for the Hexo static site generator, with three visual variants and 50+ built-in plugins. Icarus is a theme for Hexo, the Node.js static site generator. It gives blogs and personal sites a responsive layout with one to three columns, a navbar that folds sub-menus into a menu button on small screens, and a mobile table of contents. Users pick a variant in the config or in a post's front-matter: the default light/dark theme, a Cyberpunk dark style, or a Material 3 Expressive style.
Is hexo-theme-icarus free to use? What license does it have?
hexo-theme-icarus is open source under the MIT license. Check the license terms before using it in commercial products.
Is hexo-theme-icarus still maintained?
Actively maintained. The last commit to hexo-theme-icarus was on Oct 26, 2026.
What can I use hexo-theme-icarus for?
Running a personal technical blog built with Hexo. Publishing a static documentation or portfolio site with a clean look. Adding comments, analytics and donation links to a Hexo site without custom code. Creating a site that respects visitor privacy with opt-in cookie consent.
How do I install hexo-theme-icarus?
Install the theme and renderer in your Hexo site root: npm install hexo-theme-icarus hexo-renderer-inferno Switch Hexo to the Icarus theme: hexo config theme icarus Start the local server and preview the site: hexo server
Where can I get hexo-theme-icarus?
The source code and installation instructions are on GitHub: https://github.com/ppoffice/hexo-theme-icarus

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects