ShokaX is a modern fork of the Shoka Hexo blog theme, rebuilt on esbuild, ESM, and TypeScript, with a completely rewritten Vue 3 music player. It is a Hexo theme that takes Markdown posts as input and outputs a static blog, and it is developed by the ShokaX team as a community-driven successor to Shoka. The project is maintained on GitHub under the theme-shoka-x organization and is licensed AGPL-3.0-or-later.
What is Hexo Theme ShokaX?
Hexo Theme ShokaX is a fork of the Shoka theme for the Hexo static site generator, delivering a modernized codebase and new features. It accepts Markdown content and Hexo configuration as input and produces a fully static, deployable blog as output. The theme is built by the ShokaX team, with contributions acknowledged from D-Sketon, MqyGalaxy, and others listed in the README.
What makes ShokaX stand out?
- esbuild-based build system — Uses esbuild for a semi-modern build pipeline that compiles assets more quickly than Shoka's original tooling.
- Modern ESM/TypeScript codebase — The theme source is written in ECMAScript Modules and TypeScript, replacing Shoka's plain JavaScript.
- Modern Markdown rendering — Uses the HRMNMI renderer (hexo-renderer-multi-next-markdown-it) with built-in CSS, JS, and image optimizers.
- Vue 3 music player (Nyx Player) — A complete rewrite of the Shoka music player in Vue 3, available as a separate, platform-independent package.
- Rewritten upstream dependencies — Provides its own implementations of Pjax, Anime.js (ShokaX Anime), and Mouse-firework to reduce supply-chain risk.
- User-friendly configuration — Adjustments to configuration and options make the theme more approachable than the original Shoka.
- Ongoing animation and visual refresh — A work-in-progress rewrite of animations and visual effects is planned.
- Platform-decoupled UI framework (WIP) — ShokaX UIKit is being built as a Vue 3 component library that does not depend on Hexo, enabling reuse in other projects.
Who should use ShokaX?
ShokaX is for Hexo bloggers who want a modern, feature-rich theme without leaving the Hexo ecosystem. It is also for developers who prefer a TypeScript and ESM codebase, and for existing Shoka users looking for an actively maintained fork with new features.
- Hexo bloggers — build a static blog with out-of-the-box music playback and modern asset optimization.
- Shoka veterans — migrate from the original Shoka to a fork that keeps the familiar design while modernizing internals.
- Theme developers — extend a modular, typed codebase and contribute to subprojects like ShokaX UIKit and Nyx Player.
What can you do with ShokaX?
- Personal blogging: Write posts in Markdown and generate a static blog with esbuild-optimized assets and a Vue 3 music player.
- Comment integration: Wire up Twikoo or Waline comment systems to engage readers — the repository lists both as related topics.
- Self-hosting: Deploy the built site to GitHub Pages using the README's Actions workflow that installs pnpm, builds the TypeScript, and uploads the public directory.
How does ShokaX work?
ShokaX is installed through Hexo's package manager rather than git clone, as the README explicitly warns. After installation, you run the build script with pnpm, which compiles TypeScript and generates static files in the public directory. The README includes a GitHub Actions workflow for automated deployment to GitHub Pages.
Alternatives
Shoka is the original theme from which ShokaX is forked, making it the direct predecessor. NexT is another popular Hexo theme with a modular, classic design and a large ecosystem; ShokaX instead focuses on modern tooling and a Vue 3 player.
FAQ
Is ShokaX free?
Yes, the theme is open source under the AGPL-3.0-or-later license, and the repository is publicly available on GitHub. No payment or subscription is mentioned anywhere in the README.
What is the difference between ShokaX and Shoka?
ShokaX is a derivative of Shoka that modernizes the underlying technology: esbuild instead of the original build process, ESM/TypeScript instead of plain JavaScript, and a rewritten Vue 3 music player. The design language remains similar to Shoka's.
Does ShokaX support git clone installation?
No, the README explicitly states that ShokaX does not support the traditional Hexo theme git clone installation. You should follow the getting-started documentation for the supported installation path.
What comment systems work with ShokaX?
The repository metadata lists Twikoo and Waline as related topics, indicating integration with these comment backends is expected. The README itself focuses on build and deployment details rather than comment configuration.
What license restrictions apply?
ShokaX is licensed AGPL-3.0-or-later with additional terms under AGPLv3 Section 7, described in UsageRestrictions.md. If you modify the source code, those modifications must be open-sourced when you deploy a site, per the license's conditions.
