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:

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, an optional sticky navbar (navbar.sticky), 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.	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, GitHub Contributions, 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, Page Prefetching on Hover, Progress Bar

Most plugins are provided by hexo-component-inferno. Code blocks can use any highlight.js theme, with a separate one for dark pages. They can be folded, by default or with a >folded marker after their caption, and a folded block can keep its first lines as a faded-out preview that unfolds it when clicked:

article:
    highlight:
        fold: unfolded      # "folded", "unfolded", or "" to disable folding
        fold_preview: 5     # number of lines of the preview; 0 (the default) hides folded blocks

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.

License

MIT