by Huxpro

My Blog / Jekyll Themes / PWA

5.5K Stars 3.8K Forks Last release: Not found Apache License 2.0 574 Commits 13 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Hux Blog

I never expected this becomes popular.

User Manual πŸ‘‰

Getting Started

  1. You will need Ruby and Bundler to use Jekyll. Following Using Jekyll with Bundler to fullfill the enviromental requirement.

  2. Installed dependencies in the

$ bundle install 
  1. Serve the website (
    by default):
$ bundle exec jekyll serve  # alternatively, npm start

Development (Build From Source)

To modify the theme, you will need Grunt. There are numbers of tasks you can find in the

, includes minifing JavaScript, compiling
, adding banners to keep the Apache 2.0 license intact, watching for changes, etc.

Yes, they were inherited and are extremely old-fashioned. There is no modularization and transpilation, etc.

Critical Jekyll-related code are located in

. Most of them are Liquid templates.

This theme uses the default code syntax highlighter of jekyll, Rouge, which is compatible with Pygments theme so just pick any pygments theme css (e.g. from here and replace the content of


Interesting to know more? Checkout the full user manual!

Other Resources

Ports - Hexo by @kaijun - React-SSR by @LucasIcarus

Starter/Boilerplate - Out of date. Helps wanted for updating it on par with the main repo

Translation - πŸ‡¨πŸ‡³ (somewhat outdated)


Apache License 2.0. Copyright (c) 2015-present Huxpro

Hux Blog is derived from Clean Blog Jekyll Theme (MIT License) Copyright (c) 2013-2016 Blackrock Digital LLC.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.