Hugo Stellar

Hugo Stellar is a Hugo theme that ports the popular Hexo theme Stellar to Hugo, providing a card-based blog and documentation layout with extended markdown syntax support.

What is Hugo Stellar?

Hugo Stellar is a Hugo port of the Hexo theme hexo-theme-stellar, created by Yharimium. It takes Markdown content organized in posts and docs folders and renders a static website using Hugo extended v0.109.0 or newer. The theme includes a full example site under exampleSite, and the project repository is hosted on GitHub with a live demo at https://yharim.com/. It currently has 22 stars on GitHub.

Key Features

• Posts and docs content modes — The content directory supports both posts/ for blog entries and docs/ for documentation pages, mapping to clean URL structures such as /posts/test.html and /docs/test.html.
• Extended markdown syntax — The theme supports mkdocs-style admonitions directly in article body, e.g. !!! note blocks, which are rendered as styled callouts. This feature is marked stable.
• Quick setup script — A one-liner shell sequence creates a new site, adds the theme as a git submodule, and copies the entire exampleSite so you can run hugo server immediately.
• Git submodule installation — The theme is installed via git submodule add, making it easy to update from the upstream repository.
• Hugo extended requirement — Requires Hugo extended v0.109.0 or newer, ensuring SCSS and other advanced features work.
• Demo site — A public demo at Yharim Area (https://yharim.com/) shows the theme in production use.

Who is it for?

This theme suits Hugo users who want a Stellar-like design without switching to Hexo. It's also a good fit for Hexo users migrating to Hugo who want to keep the same visual style and feature set. Documentation writers can leverage the built-in docs content type and admonition syntax, while personal bloggers can use the posts structure for articles.

Use cases

• Personal bloggers — Publish articles under content/posts/ and get clean URL routing (e.g. /posts/test.html) with a Stellar-inspired card interface.
• Technical writers — Organize manuals or guides in content/docs/ and use !!! note callouts to highlight tips, warnings, or examples.
• Hexo-to-Hugo migrators — Recreate a Stellar-based site in Hugo using the same folder layout and content structure, while upgrading to Hugo's build speed and single-binary workflow.

How does Hugo Stellar work?

The installation is automated: create a directory, initialize git, add the theme as a submodule, and copy the example site contents. Then run hugo server to preview locally. If live reload misses changes, use hugo server --disableFastRender. The example content demonstrates both posts and docs structures out of the box.

Alternatives

• Hexo theme Stellar — The original Hexo theme by xaoxuu that this Hugo port is based on; it runs on the Node.js-based Hexo generator instead of Hugo.