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
