A simple, delicate, and modern theme for the static site generator Hexo.
Preview ·
Documentation ·
Discussions ·
简体中文
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.
Highlights
Light, dark, or both |
Cyberpunk variant |
Responsive |
Configure per page |
40+ plugins built in |
Fast and accessible |
Supported plugins
| Type | Plugins | |---|---| | Comment | Artalk, Beaudar, Changyan, Cusdis, Disqus, DisqusJS, Facebook, Giscus, Gitalk 2 (preview), Gitment (deprecated), Isso, LiveRe, Twikoo, Utterances, Valine (deprecated), Waline | | Search | Algolia, Baidu, Google CSE, Insight (built-in) | | Share | AddToAny, Baidu Share (deprecated), Web Share, 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 4, Browser Capability Notice, Page Loading Animations, Page Prefetching on Hover, Progress Bar |
Most plugins are provided by hexo-component-inferno.
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.