Hexo Theme Icarus is a free, MIT-licensed blog theme for the Hexo static site generator, transforming Markdown content into a modern, feature-rich blog with a responsive layout and dozens of built-in plugin integrations.
What is Hexo Theme Icarus?
Hexo Theme Icarus is a blog theme designed for Hexo, a static site generator that converts Markdown files into fast, static HTML sites. It takes your Hexo site configuration and Markdown posts as input and outputs a complete, customizable blog with support for multiple theme variants, widgets, and plugins. The theme is maintained on GitHub by the ppoffice account and is installed via npm with the command npm install hexo-theme-icarus, followed by setting it as the active theme in Hexo's configuration file.
Key Features
- Cyberpunk theme variant — A futuristic visual style inspired by Cyberpunk 2077, available as an alternative to the default clean design.
- Extensive plugin support — Integrates over 40 plugins out of the box, including comment systems (Disqus, Gitalk, Valine, and 7 others), search providers (Algolia, Baidu, Google CSE, Insight), sharing buttons (AddThis, ShareThis, and more), and analytics tools (Google Analytics, Baidu Statistics, Hotjar, among others).
- Over 90 code highlight themes — Directly imports stylesheets from highlight.js, giving you choices like Atom One Light, Monokai, and Kimbie Dark for code blocks.
- Flexible per-page configuration — Allows you to override global settings on a per-page or per-layout basis using front-matter or separate
_config.page.ymlfiles, giving you fine-grained control over widgets and layout. - Responsive layout — Provides a mobile-friendly design that adapts to different screen sizes, ensuring a good reading experience on phones and tablets.
- Widget collection — Includes a variety of sidebar widgets such as profile, recent posts, categories, tags, table of contents, archives, and external site links.
- Math rendering — Supports both KaTeX and MathJax for displaying mathematical formulas in posts.
Who is it for?
- Bloggers and writers — Want a clean, modern blog with minimal setup and a wide range of plugins for comments, sharing, and analytics.
- Web developers — Need a customizable Hexo theme that can be configured per page or per layout, with access to over 90 syntax highlighting themes for code-heavy posts.
- Technical documentation teams — Can use the built-in search plugins, table of contents widget, and responsive layout to publish docs or tutorials as a static site.
- Static site enthusiasts — Prefer a self-hosted, lightweight blogging solution without the overhead of a dynamic CMS.
What can you do with Hexo Theme Icarus?
- Start a personal blog — Install the theme, write Markdown posts, and publish a feature-rich blog with comments, sharing, and newsletter widgets in minutes.
- Add community features — Connect a commenting system like Disqus or Gitalk, and add donation buttons for Patreon, Paypal, or Alipay to engage with readers.
- Optimize for search — Integrate Algolia or Google CSE search to help visitors find content quickly, and enable analytics to track site traffic.
- Create a code-focused blog — Use the diverse code highlight themes and MathJax/KaTeX support to share programming tutorials or technical articles.
How does Hexo Theme Icarus work?
- Install the theme with
npm install hexo-theme-icarus. - Set the theme in your Hexo config file with
hexo config theme icarus. - Configure widgets, plugins, and theme variants in
_config.ymlor per-page front-matter. - Generate and deploy your static site using standard Hexo commands like
hexo generateandhexo deploy.
FAQ
Is Hexo Theme Icarus free?
Yes, Hexo Theme Icarus is open-source and released under the MIT License, so you can use it freely for personal or commercial projects, modify it, and resell it with attribution.
How do I install Hexo Theme Icarus?
Install it via npm by running npm install hexo-theme-icarus in your Hexo project, then activate it with hexo config theme icarus. Detailed getting-started instructions are available in the official documentation.
Does it support comments?
Yes, the theme works with 10 comment systems out of the box, including Disqus, Gitalk, Utterance, Valine, and Facebook Comments. You can enable one in the theme configuration.
Can I use my own analytics?
Yes, it supports a wide range of analytics services such as Google Analytics, Baidu Statistics, Hotjar, and StatCounter. Just add your tracking ID to the theme config.
How many code highlight themes are there?
Icarus imports over 90 different code highlighting styles from the highlight.js library, so you can choose a look that matches your site, from popular ones like Monokai to subtle light themes.
