Bring order to everything you publish

True simplicity is not just subtraction; it is creating order within complexity.

A complete system for organizing content

Start with regular posts. Give a project its own Wiki when it needs stable documentation, collect related posts into a Topic, and keep evolving knowledge in a Notebook. They share the same navigation, search, sidebars, and reading experience, while unused content systems stay out of the way.

Flexible layout and expression

From appearance presets, colors, and type to columns, tabs, folding sections, and galleries, you can shape both the site and the way its content is presented. Local search can take readers directly to a matching section, while responsive layouts leave the main space to the article on narrow screens.

Static pages that stay fresh

Your writing preserves ideas while external data stays current. Remote content, community data, and external services can load on demand without being coupled to the static article, so frequently changing data does not require a full-site rebuild.

Site examples

Stellar Examples provides runnable sites you can explore before replacing their content and configuration at your own pace. Visit Site examples for more real sites.

Get started

Requirements

• Node.js 22 or newer (theme development checks require Node.js 22.13+ or 24+)
• Hexo 8 or newer

Create from a Blueprint

With Git and npm available, launch the interactive Blueprint installer with one command:

macOS / Linux:

sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"

Windows PowerShell 7+ (pwsh):

& ([scriptblock]::Create((Invoke-RestMethod https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.ps1)))

The installer reads the example repository's blueprints.json, presents the available Blueprints, then confirms the Blueprint, project directory, dependency installation, and creation plan.

Install from npm

Install the default version currently provided by npm, then confirm what was installed:

npm install hexo-theme-stellar
npm ls hexo-theme-stellar

Follow the latest source

Add the official repository's main branch as a submodule and install the theme's own dependencies:

git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
npm install --prefix themes/stellar

Enable and check

Enable the theme in your site's _config.yml:

theme: stellar

Then run Doctor and generate the site:

npx hexo stellar doctor
npx hexo generate

See Installation and Create your first site for the complete workflow.

Documentation and community

• Configure your site
• Use content components
• Manage Wikis, Topics, and Notebooks
• Theme configuration reference
• Migrate from v1 to v2
• Issues for reproducible problems
• Discussions for ideas and usage questions
• Contributing for code and documentation work

License

Stellar is free and open source under the MIT License. Third-party licenses are listed in THIRD-PARTY-NOTICES.md.