Beantech

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: true and 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_tag setting.
• Signature display — Add a signature image below posts by configuring signature and signature-img.
• Custom sidebar avatar — Drop an image in the img folder and point sidebar-avatar to it.
• Markdown-it integration — Uses hexo-renderer-markdown-it with 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.