# ppoffice/hexo-theme-icarus

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ppoffice-hexo-theme-icarus).**

6,661 stars · 1,537 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/ppoffice/hexo-theme-icarus
- Homepage: https://ppoffice.github.io/hexo-theme-icarus/
- awesome-repositories: https://awesome-repositories.com/repository/ppoffice-hexo-theme-icarus.md

## Topics

`hexo` `hexo-theme` `static-site` `theme`

## Description

Hexo Theme Icarus is a modern, delicate theme for the Hexo static site generator. It provides a flexible layout and widget configuration system, with all appearance and behavior controlled through a single YAML or JSON configuration file that is validated against JSON schemas during each build.

The theme distinguishes itself through a configuration-driven architecture that supports per-page and per-post layout overrides, automatic configuration migration, and a component override mechanism that allows replacing built-in widgets, comments, and share components by copying layout files. It integrates a plugin-widget layer for adding third-party features like comments, search, analytics, and donation buttons, and supports schema-validated configuration with exact error reporting for invalid settings.

The theme covers a broad capability surface including content metadata display (cover images, reading time, licensing, update times), content navigation widgets (archives, categories, tags, related posts, table of contents), author profile cards, code highlighting with over 90 highlight.js themes, responsive mobile-friendly layout, social sharing buttons, and visitor analytics integration with services like Google Analytics, Baidu, Hotjar, and Twitter. It also provides search indexing via Algolia or local search, PWA support through web app manifest generation, and CDN asset delivery for improved page load performance.

## Tags

### Content Management & Publishing

- [Hexo Themes](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes/hexo-themes.md) — Provides a modern, delicate theme for the Hexo static site generator with flexible layout and widget configuration.
- [Plugin Integrations](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes/hexo-themes/plugin-integrations.md) — Adds third-party features like comments, search, and analytics by configuring plugin and widget entries.
- [Blog Content Navigation Widgets](https://awesome-repositories.com/f/content-management-publishing/content-discovery-organization/blog-content-navigation-widgets.md) — Provides archives, categories, tags, related posts, and table of contents for browsing content.
- [Static Site Generation](https://awesome-repositories.com/f/content-management-publishing/static-site-document-generators/static-site-generators/static-site-generation.md) — Extends the Hexo build pipeline by injecting custom layout files and configuration schemas.
- [Author Profiles](https://awesome-repositories.com/f/content-management-publishing/author-profiles.md) — Shows a sidebar card with the author's avatar, bio, and social links to personalize the blog. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Widgets/))
- [Comment Widget Integrations](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes/hexo-themes/comment-widget-integrations.md) — Integrates third-party comment widgets like Disqus and Facebook Comments into blog posts.
- [Search Engine Integrations](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes/hexo-themes/search-engine-integrations.md) — Embeds site-wide search tools such as Algolia or local search for static content.
- [Syntax Highlighting Integrations](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes/hexo-themes/syntax-highlighting-integrations.md) — Applies over 90 syntax-highlighting themes from highlight.js with copy and fold controls.
- [Analytics Integrations](https://awesome-repositories.com/f/content-management-publishing/comment-system-integrations/analytics-integrations.md) — Connects third-party analytics services to collect visitor statistics and page-view data automatically. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Other/))
- [Per-Page Layout Overrides](https://awesome-repositories.com/f/content-management-publishing/page-layout-configurations/per-page-layout-overrides.md) — Allows overriding theme settings like widget placement on individual pages or post types. ([source](https://cdn.jsdelivr.net/gh/ppoffice/hexo-theme-icarus@master/README.md))
- [Page View Tracking](https://awesome-repositories.com/f/content-management-publishing/page-view-tracking.md) — Integrates third-party analytics services to record and report visitor page views and site traffic. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Analytics/))

### Software Engineering & Architecture

- [Third-Party Plugins](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/third-party-plugins.md) — Adds ready-made support for comments, search, analytics, sharing, and donation widgets without manual coding. ([source](https://ppoffice.github.io/hexo-theme-icarus/tags/Icarus%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97/))
- [Front-Matter Overrides](https://awesome-repositories.com/f/software-engineering-architecture/configuration-variables/theme-configuration-overrides/front-matter-overrides.md) — Sets theme settings for a single post or page directly in its front-matter, overriding defaults. ([source](https://ppoffice.github.io/hexo-theme-icarus/Configuration/icarus-user-guide-configuring-the-theme/))
- [Layout-Specific Overrides](https://awesome-repositories.com/f/software-engineering-architecture/configuration-variables/theme-configuration-overrides/layout-specific-overrides.md) — Applies different theme settings to all posts versus all custom pages using separate layout configuration files. ([source](https://ppoffice.github.io/hexo-theme-icarus/Configuration/icarus-user-guide-configuring-the-theme/))

### User Interface & Experience

- [Plugin-Based Widget Systems](https://awesome-repositories.com/f/user-interface-experience/custom-widget-frameworks/extensible-ui-component-kits/plugin-based-widget-systems.md) — Adds third-party features like comments, search, and analytics by integrating supported plugins and widgets. ([source](https://ppoffice.github.io/hexo-theme-icarus/tags/Getting-Started/))
- [Widget Configuration](https://awesome-repositories.com/f/user-interface-experience/sidebar-layouts/widget-configuration.md) — Places and configures sidebar widgets such as recent posts, tags, and archives. ([source](https://ppoffice.github.io/hexo-theme-icarus/))
- [Theme Settings Configurations](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/theme-management/theme-development/theme-settings-configurations.md) — Controls site-wide appearance, layout, and behavior through a single YAML or JSON configuration file. ([source](https://ppoffice.github.io/hexo-theme-icarus/archives/2020/03/))
- [SEO and Metadata Optimization](https://awesome-repositories.com/f/user-interface-experience/landing-page-templates/seo-and-metadata-optimization.md) — Sets Open Graph metadata, structured data, and social share buttons to improve search engine visibility and link previews.
- [Responsive Layout Optimizations](https://awesome-repositories.com/f/user-interface-experience/responsive-layout-optimizations.md) — Renders the blog with a mobile-friendly layout that adapts to different screen sizes. ([source](https://cdn.jsdelivr.net/gh/ppoffice/hexo-theme-icarus@master/README.md))
- [Syntax Highlighting Themes](https://awesome-repositories.com/f/user-interface-experience/syntax-highlighting-themes.md) — Switches among over 90 syntax-highlighting color schemes imported directly from highlight.js. ([source](https://cdn.jsdelivr.net/gh/ppoffice/hexo-theme-icarus@master/README.md))
- [Code Block Themes](https://awesome-repositories.com/f/user-interface-experience/visual-theme-configurations/visual-themes/theme-customization/code-block-themes.md) — Selects a highlight.js theme and controls copy button and folding behavior for code blocks in articles. ([source](https://ppoffice.github.io/hexo-theme-icarus/Configuration/icarus-user-guide-configuring-the-theme/))

### Web Development

- [YAML-Driven Configurations](https://awesome-repositories.com/f/web-development/single-page-applications/single-file-distributions/json-driven-configurations/yaml-driven-configurations.md) — Controls appearance and behavior entirely through a single YAML or JSON configuration file parsed at build time.
- [Web Visitor Analytics](https://awesome-repositories.com/f/web-development/web-visitor-analytics.md) — Embeds multiple analytics services like Google Analytics, Baidu, and Hotjar to collect visitor data.

### Data & Databases

- [Visual Content Searches](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/content-search-filters/visual-content-searches.md) — Indexes blog posts and pages and provides a search interface for visitors to find relevant content. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Search/))
- [Static Site Search Indices](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/static-site-search-indices.md) — Indexes site content and provides a search interface for visitors to find posts without a server-side database. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Search/))
- [Search Input Widgets](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-information-retrieval/matching-ranking-logic/keyword-search/search-input-widgets.md) — Places a search input widget that lets visitors find posts by keyword. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Widgets/))

### Development Tools & Productivity

- [Theme Overrides](https://awesome-repositories.com/f/development-tools-productivity/global-configurations/theme-overrides.md) — Supports per-page and per-post settings that override global theme defaults via front-matter and layout files.
- [Layout File Overrides](https://awesome-repositories.com/f/development-tools-productivity/global-configurations/theme-overrides/layout-file-overrides.md) — Replaces built-in widget, comment, or share components by copying layout files from a shared package. ([source](https://ppoffice.github.io/hexo-theme-icarus/uncategorized/faq/))
- [Per-Page Overrides](https://awesome-repositories.com/f/development-tools-productivity/global-configurations/theme-overrides/per-page-overrides.md) — Supports overriding theme settings for individual pages or post types to customize widgets and appearance. ([source](https://cdn.jsdelivr.net/gh/ppoffice/hexo-theme-icarus@master/README.md))

### Security & Cryptography

- [Comment Widget Integrations](https://awesome-repositories.com/f/security-cryptography/third-party-integrations/comment-widget-integrations.md) — Integrates third-party comment widgets into blog posts so readers can leave and view discussions. ([source](https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Comment/))
