hexo-theme-icarus

Quick Start

For a published install, in the root directory of a Hexo site compatible with ^7.1.1 || ^8.0.0:

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 requirements, source installs, and the distinction between published packages and the current development checkout.

Three Variants

One line in _config.icarus.yml, or in the front-matter of a single post, switches the whole look.

Highlights

Also built in:

• Fast navigation: PJAX page loading with scroll restoration on Back/Forward, and page prefetching on hover.
• Reading: a reading progress bar, folded code blocks with a preview, and a notice on posts that have not been updated for a long time.
• Math and images: KaTeX or MathJax 4, and lightGallery 3 with Justified Gallery.
• Privacy: in opt-in mode, Cookie Consent loads the built-in analytics only after visitors allow them; Web Share shares without a third-party SDK.
• Accessible: keyboard navigation, screen reader labels, / or Ctrl+K to search, and translations into 17 languages.

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

Most integrations are provided by hexo-component-inferno.

Documentation

Getting Started · Configuring the Theme · Upgrade Guide · FAQ · Demos · 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