About

A simple, delicate, and modern theme for the static site generator Hexo.
Preview · Documentation · Discussions · 简体中文

Quick Start

In the root directory of your Hexo 7.1+ or Hexo 8 site:

1
2
3

npm install hexo-theme-icarus hexo-renderer-inferno
hexo config theme icarus
hexo server

Icarus creates _config.icarus.yml, with every option described, on the first run. See Getting Started for other ways to install it.

Highlights

Light, dark, or both
Follow each visitor's system setting with appearance: auto, or go dark everywhere.

Cyberpunk variant
A second look of neon-lit nights, HUD frames and scanlines, one line away.

Responsive
One to three columns, navbar sub-menus that fold into a menu button, and a mobile table of contents.

Configure per page
Set options site-wide, override them per layout in _config.post.yml, or per post in its front-matter.

40+ plugins built in
Comments, search, sharing, donations, analytics and widgets, ready to switch on in the config.

Navbar sub-menu opened with the keyboard

Fast and accessible
PJAX page loading, keyboard and screen reader support, and translations into 17 languages.

Supported plugins

Type	Plugins
Comment	Artalk, Beaudar, Changyan, Cusdis, Disqus, DisqusJS, Facebook, Giscus, Gitalk, Gitment (deprecated), Isso, LiveRe, Twikoo, Utterances, Valine (deprecated), Waline
Search	Algolia, Baidu, Google CSE, Insight (built-in)
Share	AddToAny, Baidu Share, Share.js, ShareThis
Donate	Afdian, Alipay, Buy Me a Coffee, Patreon, PayPal, WeChat Pay
Analytics	Baidu Statistics, Bing Webmaster, BuSuanZi, CNZZ, Google Analytics, Hotjar, Matomo, StatCounter, Twitter Conversion Tracking, Umami, Waline page views
Widgets	Profile, Table of Contents, Recent Posts, Archives, Categories, Tags, Links, Google AdSense, follow.it, Google FeedBurner (deprecated)
Others	Back to Top, Cookie Consent, Gallery (lightGallery + Justified Gallery), KaTeX, MathJax, Outdated Browser, Page Loading Animations, Progress Bar

Most plugins are provided by hexo-component-inferno. Deprecated plugins rely on services that have shut down or are about to, and Hexo prints a warning when one is enabled. Code blocks can use any highlight.js theme, with a separate one for dark pages.

Documentation

Getting Started · Configuring the Theme · Upgrade Guide · FAQ ·

All Guides

Contributing

Bug reports, feature ideas, translations and tutorials are all welcome. Open an issue or a pull request.

Icarus is built with Hexo, Inferno, Stylus and Bulma. To work on it:

npm ci
npm run lint
npm test            # unit and integration tests
npm run test:e2e    # browser tests; run "npx playwright install chromium" once first

The tests need Node.js 20.19 or later. See the contributing guide for code style and commit conventions.