Heoweb is a personal homepage theme for the Hexo static site generator, ported from the HeoWeb project by zhheo, that turns a single Hexo site into a personal profile page with links and self-introduction.
What is Heoweb?
Heoweb is a Hexo theme that serves as a personal homepage rather than a full blog layout. It is a port of the original HeoWeb project (github.com/zhheo/HeoWeb) into the Hexo ecosystem, so it inherits the visual design of HeoWeb while running natively under Hexo's theming system. The theme takes your Hexo site's content and configuration as input and produces a static HTML homepage as output. It is developed by rootlexblog, as indicated by the GitHub repository, and is open source with a public issue tracker for bug feedback.
Key Features
- Hexo theme — Installed as a theme in any Hexo site by cloning the repository into the
themes/heowebdirectory; the site then renders with the Heoweb layout. - HeoWeb port — Directly from zhheo/HeoWeb, preserving the original homepage design and adapting it to Hexo's template structure.
- Separate config file — Uses a dedicated
_config.heoweb.ymlfile inside the theme, keeping your personal settings separate from the theme's default_config.yml. - Static output — Because it is a Hexo theme, the final site is a set of static files, which can be hosted anywhere that serves plain HTML.
- Stylus styling — The theme's styles are written in Stylus, a CSS preprocessor, compiling to standard CSS during the Hexo build process.
- Demo sites — Live previews include the original HeoWeb demo at zhheo.com and the Heoweb port demo at nalex.top.
- Open source development — The repository is on GitHub with an Issues page for reporting bugs and a contributing guide for pull requests.
Who is it for?
- Hexo users who want to replace their default blog theme with a dedicated personal homepage for profile and link sharing.
- Fans of HeoWeb who want to use its design but are already invested in the Hexo static site generator.
- Personal site owners who need a quick, minimal single-page presence with a custom domain.
What can you do with Heoweb?
- Personal branding: Set up a modern homepage that shows your name, photo, and social links using Hexo's Markdown-driven content.
- Portfolio link page: Display a short bio and a curated list of projects or profiles in a single, self-contained page.
- Quick personal landing page: Use it as a replacement for a blank index page or as a link-in-bio style page for your own domain.
How does Heoweb work?
- Clone the theme into your Hexo site's
themesfolder:git clone -b master https://github.com/rootlexblog/Heoweb.git themes/heoweb. - Change your site's
_config.ymlto settheme: heoweb. - Create a
_config.heoweb.ymlfile in the theme folder and copy the contents of the theme's default_config.ymlinto it for customization.
The theme then uses your Hexo content and the settings in that config file to generate a static homepage on every hexo generate build.
FAQ
Is Heoweb free?
Yes, Heoweb is open source and free to download from its GitHub repository. There is no mention of any paid tier or premium features.
How do I install Heoweb?
Make sure you have a working Hexo environment first. Then clone the repository into your site's themes directory using the git clone command shown in the installation section, and set theme: heoweb in your site config.
How do I customize Heoweb?
The theme uses a separate _config.heoweb.yml file. Create that file in the theme directory, copy the contents from the theme's original _config.yml, and edit the values. This lets you adjust settings without modifying the theme source.
What is the difference between Heoweb and HeoWeb?
Heoweb is a port of HeoWeb, meaning it is a version of the HeoWeb homepage designed to run inside Hexo's theme system. HeoWeb is the original project, likely built for a different platform, and its demo is at zhheo.com.
Does Heoweb include a blog?
The theme is described as a personal homepage theme, and its repository topics are "home" and "homepage", so it is intended as a single-page profile rather than a multi-post blog layout.
Pricing
Heoweb is open source and available for free through GitHub. You do not need to pay to use it, and there are no listed premium tiers.
