Beantech is a Hexo blog theme that ports the Hux Blog design from Jekyll, giving you the same clean, card-based layout on the Node.js static site generator.
What is Beantech?
Beantech is an open-source Hexo theme created by YuHsuan and modified from a port by Kaijun, based on the Hux Blog theme by Huxpro. It converts your Hexo content into a static blog with a responsive layout, sidebar, tags, signatures, and a back-to-top icon. The theme is installed via npm and configured through _config.yml, and it defaults to the hexo-renderer-markdown-it plugin for rendering.
Key Features
- Sidebar widgets — Enable the sidebar with
sidebar: trueand choose from featured-tags, short-about, recent-posts, friends-blog, archive, and category widgets. - Home post tags — Toggle homepage tag visibility using the
home_posts_tagsetting. - Signature display — Add a signature image below posts by configuring
signatureandsignature-img. - Custom sidebar avatar — Drop an image in the img folder and point
sidebar-avatarto it. - Markdown-it integration — Uses
hexo-renderer-markdown-itwith options for HTML, linkify, typographer, and custom quote characters. - Customizable anchor icon — Change the default ℬ header anchor inside
layout/post.ejs. - Git deployment — Configure deployment for a Git repository and deploy with a single command.
- Live demo — Try it at http://blog.beantech.org.
Who is it for?
- Jekyll users who loved Hux Blog — They can migrate to Hexo while keeping the same visual style.
- Hexo bloggers — They get a ready-made theme with sidebar widgets, tag display, and signature support in one package.
- Developers learning Hexo — The README walks through cloning, configuring, and deploying a full blog step by step.
Use cases
- Personal bloggers: Set up a minimal blog with a sidebar about section, recent posts, and an archive widget.
- Technology writers: Use the featured-tags and category widgets to organize lengthy posts, then deploy to GitHub Pages.
- Side-project sites: Display collaborators via the friends-blog widget and add a personal signature to each post.
How does Beantech work?
After cloning the theme to your Hexo themes directory, run npm install to install dependencies. Edit _config.yml to set your deployment repo, sidebar settings, signature, and widget selection, then run hexo generate and hexo deploy to build and publish the static site.
FAQ
How do I install Beantech?
Clone the repository, run npm install inside it, and modify _config.yml with your own information before generating your site.
How do I change the sidebar avatar?
Copy your avatar image to the img folder and set the sidebar-avatar path in _config.yml; also ensure sidebar: true is set to display it.
Can I show or hide tags on the homepage?
Yes, set home_posts_tag to true or false in your configuration to control whether post tags appear on the home page.
How do I deploy to GitHub Pages?
In _config.yml, set the deploy type to git, provide your repository URL and branch, then run hexo deploy to push the generated files.
Does the theme include a markdown renderer?
The theme is configured to work with hexo-renderer-markdown-it, and you can adjust its options under the markdown section of _config.yml.
