ICARUS Files

Upgrade Notes

• Icarus now requires hexo-component-inferno 5.0.0 or later, and inferno-server is a dependency. If you install Icarus from npm, you get them automatically, with hexo-component-inferno 5.1.0. If you cloned the theme into themes/icarus, run the install command that the dependency check prints, for example npm install --save hexo-component-inferno@^5.0.0 inferno-server@^8.2.3. See the release notes of hexo-component-inferno 5.0.0 and 5.1.0 [beb531]
• The theme configuration file does not change: its version is still 5.1.0. The new options below are off by default
• Removed integrations: Facebook Comments, Share.js, Baidu Share, AddThis and the Google FeedBurner subscribe_email widget show a notice instead of loading. Switch to another comment plugin, set share.type to web_share, addtoany or sharethis, and use the followit widget. See the hexo-component-inferno 5.0.0 release notes [beb531]
• Gitalk: Icarus uses Gitalk 2, which requires a GitHub App and your own proxy, set in proxy. Remove client_secret from your configuration and generate a new client secret, because the old one was published in your pages [beb531]
• Profile widget: it no longer falls back to /img/avatar.png when neither avatar nor gravatar is set. To keep the image, set avatar: /img/avatar.png in the widget [c2f313] 56a9f617e89e9d7d32f1366a0e5301a1941da489
• Gallery: lightGallery 3 is licensed under GPLv3 or a commercial license; check that it fits your site. Rename the justifiedGallery CDN override to justified-gallery, and replace jQuery calls to lightGallery() or justifiedGallery() in your own scripts with the native APIs [5bc84d] e930a5ac3d766b91700635b4489ba680e0826850
• MathJax: MathJax 4 loads tex-mml-chtml.js without the es5/ prefix and loads its fonts on demand. If you host MathJax yourself, mirror the whole mathjax and @mathjax/mathjax-newcm-font packages [760213]
• PJAX: PJAX is now part of the theme, so the pjax CDN override is no longer used. If you added scripts that set up the content of a page, run them on the pjax:complete event as well [3cf03b]
• If you have customized copies of these files, apply the changes of this release to them: layout/layout.jsx, layout/common/head.jsx, layout/common/navbar.jsx, layout/common/article.jsx, layout/common/plugins.jsx, layout/common/scripts.jsx, source/js/main.js and source/js/pjax.js. The navbar and PJAX code moved to source/js/navbar.js, source/js/appearance.js and source/js/pjax-*.js, and layout/widget/profile.jsx is removed [9742f9] a0dbc4d40a5ecf393656d15712b4827efadfe7f4 [c2f313]
• Cusdis is deprecated and prints a warning: it was archived on July 17, 2026. Switch to another comment plugin 8187984

New Features

• Material 3 Expressive variant: variant: m3e brings tinted surfaces, rounded cards and pill-shaped controls that change shape on hover and keyboard focus, in light, dark or auto appearance (see the Material 3 Expressive Theme Variant post) [0086cb] fab96ef24b3592f6a19d60561875a356a147ce6d [c29588] f5bbc44a2c6d92db48b57605e5aa99521b97ea21
• Appearance switch: pages with appearance: auto have a sun and moon button in the navbar. Visitors can pick light or dark, and their browser remembers the choice [74cad5]
• Web Share: share.type: web_share shows links to X, Facebook, Weibo, Telegram and LinkedIn, and a button for the share menu of the visitor's device, without a third-party SDK [8a654b]
• GitHub contribution calendar: the github_calendar widget shows the contributions of a GitHub user. No GitHub token is needed [d56771]
• Reading progress bar: posts show how far they have been read in a 3px bar at the top of the window, in browsers that support scroll-driven animations [ce1fa5]
• Cookie Consent: with type: opt-in, the web analytics plugins only load after the visitor allows cookies; with opt-out, they stop loading after the visitor declines them. info remains a notice only [966e7f]
• LiveRe: set client_id to the client-id of the installation code from LiveRe Admin to use the current LiveRe widget. uid keeps loading the legacy LiveRe City code e2069ac

Improvements

• PJAX keeps working through Back and Forward, restoring the scroll position of each page, and reinitializes the navbar, comments, math and gallery of the pages it switches to [3cf03b] 9742f9435479c878cef915d81688c7556fbe9d73 [210505] a0dbc4d40a5ecf393656d15712b4827efadfe7f4
• The gallery uses lightGallery 3 and justified-gallery 4 in all variants and across PJAX page switches [5bc84d] e930a5ac3d766b91700635b4489ba680e0826850
• MathJax 4 typesets the expressions of each page switched to with PJAX [760213]
• The outdated browser notice checks the CSS features that the variant needs, instead of loading the old detection library [46d059]
• Google Custom Search results follow the colors and fonts of the theme, with compact thumbnails and controls that fit narrow screens [3a5baa]
• The default author avatar is replaced [a21c3e]
• The README presents the three variants and the supported integrations [533500]
• Tests: cover dates, rendering, the published Artalk, Waline, KaTeX and Valine clients, Disqus color parsing and behavior on different platforms [7ef6ac] 62274bab31bb21af195a7a65e54472a5d884582a [e13674] f9108b9365b4524094047baca60368174b4f5fdd [694c58] 1fb6876a1e8e43198dce35fcf17b27056951dcf2

Bug Fixes

• Cyberpunk: fix comment plugins and code highlighting turning light for visitors whose system prefers a light color scheme, and fix the colors of code and tag fonts, ShareThis counts, dropdowns and messages [562154]
• Gallery: fix lightbox captions being hard to read, and the gallery styles after switching CDN providers [d8aab4]
• CI: fix the Cookie Consent tests and the keyboard focus test of the navbar sub-menus being unreliable [238f22]